-- verified all 1.0.2 scheduled issues

-- added POM comments

git-svn-id: http://maven-alfresco-archetypes.googlecode.com/svn/trunk@689 04253f4f-3451-0410-a141-5562f1e59037

archetypes/alfresco-allinone-archetype/src/main/resources/archetype-resources/pom.xml

@@ -15,16 +15,21 @@
     </parent>
     
     <!-- 
-       | SDK properties have sensible defaults in the SDK parent,
+       | SDK properties have sensible defaults in the SDK parent, but you can override the properties below to use another version. 
-       | but you can override the properties below to use another version. 
        | For more available properties see the alfresco-sdk-parent POM. 
        -->
     <properties>
+        <!-- 
+            | Defines the Alfresco GroupId \ Edition to work against. Allowed values are: org.alfresco | org.alfresco.enterprise
+            | NOTE: Please Refer to Alfresco Support for access to Enterprise artifacts -->
         <alfresco.groupId>${alfresco_target_groupId}</alfresco.groupId>
+        <!-- Defines the Alfresco version to work against. Allowed values are: org.alfresco | org.alfresco.enterprise -->
         <alfresco.version>${alfresco_target_version}</alfresco.version>
+        <!-- This control the root logging level for all apps -->
         <app.log.root.level>WARN</app.log.root.level>
+        <!-- This controls the default data location for dir.root -->
         <alfresco.data.location>alf_data_dev</alfresco.data.location>
-        <!-- This controls which properties will be picked in src/test/properties for embedded run -->
+        <!-- This controls which properties will be picked in multi-enviromment build -->
         <env>local</env>
     </properties>
 
@@ -46,17 +51,21 @@
      </dependencies>
   </dependencyManagement>
   
-    <!--
+    <!-- This repository is only needed to retrieve Alfresco parent POM. 
-    No more repos are needed since they will be inherited by the parent POM. 
+        NOTE: This can be removed when/if Alfresco will be on Maven Central 
-    This is needed to download the alfresco-plaftorm POM.
+        
-    -->
+        NOTE: The repository to be used for Alfresco Enterprise artifacts is
+        https://artifacts.alfresco.com/nexus/content/groups/private/. Please check
+        with Alfresco Support to get credentials to add to your ~/.m2/settings.xml
+        if you are a Enterprise customer or Partner  
+        -->
     <repositories>
         <repository>
-            <id>alfresco-artifacts</id>
+            <id>alfresco-public</id>
             <url>https://artifacts.alfresco.com/nexus/content/groups/public</url>
         </repository>
         <repository>
-            <id>alfresco-artifacts-snapshots</id>
+            <id>alfresco-public-snapshots</id>
             <url>https://artifacts.alfresco.com/nexus/content/groups/public-snapshots</url>
         </repository>
     </repositories>

archetypes/alfresco-amp-archetype/src/main/resources/archetype-resources/pom.xml

@@ -21,14 +21,19 @@
        | For more available properties see the alfresco-sdk-parent POM. 
        -->
     <properties>
+        <!-- Defines the alfresco edition to compile against. Allowed values are [org.alfresco|org.alfresco.enterprise]--> 
         <alfresco.groupId>${alfresco_target_groupId}</alfresco.groupId>
+        <!-- Defines the alfresco version to compile against -->
         <alfresco.version>${alfresco_target_version}</alfresco.version>
         <app.log.root.level>WARN</app.log.root.level>
         <alfresco.data.location>alf_data_dev</alfresco.data.location>
-        <!-- Defines the target WAR for this AMP. Allowed values: alfresco | share  -->
+        <!-- Defines the target WAR artifactId to run this amp, only used with the -Pamp-to-war switch
-        <!-- Defaults to a repository AMP -->
+        .    | Allowed values: alfresco | share. Defaults to a repository AMP, but could point to your foundation WAR -->
         <alfresco.client.war>${alfresco_target_amp_client_war}</alfresco.client.war>
+        <!-- Defines the target WAR groupId to run this amp, only used with the -Pamp-to-war switch
+        .    | Could be org.alfresco | org.alfresco.enterprise or your corporate groupId -->
         <alfresco.client.war.groupId>${alfresco_target_amp_client_war_groupId}</alfresco.client.war.groupId>
+        <!-- Defines the target WAR version to run this amp, only used with the -Pamp-to-war switch -->
         <alfresco.client.war.version>${alfresco_target_amp_client_war_version}</alfresco.client.war.version>
         <!-- This controls which properties will be picked in src/test/properties for embedded run -->
         <env>local</env>
@@ -69,7 +74,13 @@
     </dependencies>
 
     <!-- This repository is only needed to retrieve Alfresco parent POM. 
-        NOTE: This can be removed when/if Alfresco will be on Maven Central -->
+        NOTE: This can be removed when/if Alfresco will be on Maven Central 
+        
+        NOTE: The repository to be used for Alfresco Enterprise artifacts is
+        https://artifacts.alfresco.com/nexus/content/groups/private/. Please check
+        with Alfresco Support to get credentials to add to your ~/.m2/settings.xml
+        if you are a Enterprise customer or Partner  
+        -->
     <repositories>
         <repository>
             <id>alfresco-public</id>