improved text

git-svn-id: https://svn.apache.org/repos/asf/maven/pom/trunk@1703006 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/maven/pom.xml b/maven/pom.xml
index bc9094a..dc2669e 100644
--- a/maven/pom.xml
+++ b/maven/pom.xml
@@ -855,7 +855,7 @@
   <build>
     <pluginManagement>
       <plugins>
-        <!-- The Maven universe targets Java 5 minimum -->
+        <!-- The Maven universe targets Java 5 minimum, with generics -->
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-plugin-plugin</artifactId>
diff --git a/maven/src/site-docs/apt/index.apt.vm b/maven/src/site-docs/apt/index.apt.vm
index f74ff8f..f8d3567 100644
--- a/maven/src/site-docs/apt/index.apt.vm
+++ b/maven/src/site-docs/apt/index.apt.vm
@@ -33,8 +33,8 @@
     This POM is the common parent of all of the Maven components
     in the Apache Maven project. Most of its contents are
     pinning down version numbers of plugins. It does 
-    provide minimal dependencyManagement for <<<org.codehaus.plexus:plexus-component-annotations>>>
-    and <<<org.apache.maven.plugin-tools:maven-plugin-annotations>>>.
+    provide {{{./dependency-management.html}minimal dependencyManagement}} for
+    plexus-component and plugin-tools annotations.
 
     This POM contains Maven developers information for the {{{./team-list.html}Project Team report}},
     sorted by role and id.
@@ -58,13 +58,14 @@
 
 Site Publication
 
-    This POM prepares site publication to svnpubsub. Every inheriting POM needs to define <<<maven.site.path>>> property
+    This POM prepares site publication to {{{/developers/website/index.html}Apache Maven's site svnpubsub}}.
+    Every inheriting POM needs to define <<<maven.site.path>>> property
     with relative path to <<<$\{project.artifactId}-LATEST>>> publication uri, and define <<<distributionManagement>>> to avoid
     automatic inheritance from parent:
 
 +-----+
   <properties>
-    <maven.site.path>xxx-archives/${project.artifactId}-LATEST</maven.site.path>
+    <maven.site.path>xxx-archives/artifactId-LATEST</maven.site.path>
   </properties>
   <distributionManagement>
     <site>