From 4abb2ac9abe61bc99d959fa795533fdec692d076 Mon Sep 17 00:00:00 2001
From: Herve Boutemy <hboutemy@apache.org>
Date: Sat, 3 Sep 2011 19:58:05 +0000
Subject: [PATCH] added an introduction to model building steps

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-3/trunk@1164921 13f79535-47bb-0310-9956-ffa450edef68
---
 maven-model-builder/src/site/apt/index.apt | 61 ++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 maven-model-builder/src/site/apt/index.apt

diff --git a/maven-model-builder/src/site/apt/index.apt b/maven-model-builder/src/site/apt/index.apt
new file mode 100644
index 0000000000..d68fba12a9
--- /dev/null
+++ b/maven-model-builder/src/site/apt/index.apt
@@ -0,0 +1,61 @@
+ -----
+ Introduction
+ -----
+ Hervé Boutemy
+ -----
+ 2011-09-03
+ -----
+
+Maven Model Builder
+
+ The effective model builder, with inheritance, profile activation, interpolation, ...
+
+ The main component is <<<ModelBuilder>>>
+ ({{{./apidocs/org/apache/maven/model/building/ModelBuilder.html}javadoc}},
+ {{{./xref/org/apache/maven/model/building/ModelBuilder.html}source}}),
+ with its <<<DefaultModelBuilder>>> implementation
+ ({{{./apidocs/org/apache/maven/model/building/DefaultModelBuilder.html}javadoc}},
+ {{{./xref/org/apache/maven/model/building/DefaultModelBuilder.html}source}})
+ that manages the steps sequence.
+
+ The sequence is divided into 2 phases, with optional plugin processing:
+
+ * phase 1
+
+   ** profile activation
+
+   ** model normalization
+
+   ** profile injection
+
+   ** parent resolution
+
+   ** inheritance assembly
+
+   ** model interpolation
+
+   ** url normalization
+
+   []
+
+ * phase 2
+
+   ** model path translation
+
+   ** plugin management injection
+
+   ** <(optional)> lifecycle bindings injection
+
+   ** dependency management injection
+
+   ** <(optional)> reports configuration
+
+   ** <(optional)> reports conversion to decoupled site plugin
+
+   ** <(optional)> plugins configuration
+
+   ** effective model validation
+
+   []
+
+ []