-- javadocs and site improvements

-- forgot wcmqs in archetype

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

archetypes/alfresco-allinone-archetype/pom.xml

@@ -5,8 +5,8 @@
   <groupId>org.alfresco.maven.archetype</groupId>
   <artifactId>alfresco-allinone-archetype</artifactId>
   <packaging>maven-archetype</packaging>
-  <name>alfresco-allinone-archetype</name>
+  <name>All-in-One Archetype from Maven Alfresco SDK</name>
-  <description>Sample multi-module project for All-in-One development on the Alfresco plaftorm. Includes modules for: Repository, AMP, Share, Solr and embedded Jetty run</description>
+  <description>Sample multi-module project for All-in-One development on the Alfresco plaftorm. Includes modules for: Repository, AMP, Share, Solr, Web Quick Start and embedded Jetty run</description>
   
   <parent>
     <groupId>org.alfresco.maven</groupId>

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

@@ -56,6 +56,10 @@
                                     <war>${project.basedir}/../share/target/share.war</war>
                                     <contextPath>/share</contextPath>
                                 </contextHandler>
+                                <contextHandler implementation="org.mortbay.jetty.webapp.WebAppContext">
+                                    <war>${project.basedir}/../wcmqs/target/wcmqs.war</war>
+                                    <contextPath>/wcmqs</contextPath>
+                                </contextHandler>
                             </contextHandlers>
                             <systemProperties>
                                 <systemProperty>

archetypes/alfresco-amp-archetype/.classpath

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry excluding="**" kind="src" output="target/classes" path="src/main/resources"/>
+	<classpathentry excluding="**" kind="src" output="target/test-classes" path="src/test/resources"/>
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/J2SE-1.4"/>
+	<classpathentry kind="con" path="org.maven.ide.eclipse.MAVEN2_CLASSPATH_CONTAINER"/>
+	<classpathentry kind="output" path="target/classes"/>
+</classpath>

archetypes/alfresco-amp-archetype/.project

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>alfresco-amp-archetype</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.maven.ide.eclipse.maven2Builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+		<nature>org.maven.ide.eclipse.maven2Nature</nature>
+	</natures>
+</projectDescription>

plugins/alfresco-maven-plugin/src/main/java/org/alfresco/maven/plugin/AmpMojo.java

@@ -36,6 +36,7 @@ import org.codehaus.plexus.archiver.jar.JarArchiver;
  * @phase package
  * @requiresProject
  * @threadSafe
+ * @since 1.0
  * @requiresDependencyResolution runtime
  * @description Packages an Alfresco AMP file in ${project.build.directory} using the content found in ${project.build.directory}/${project.build.finalName}
  */

plugins/alfresco-maven-plugin/src/main/java/org/alfresco/maven/plugin/InstallMojo.java

@@ -16,6 +16,7 @@ import org.apache.maven.plugin.MojoFailureException;
  * 
  * @version $Id:$
  * @requiresDependencyResolution
+ * @since 1.0
  * @goal install
  * @description Installs one or more AMPs onto an Alfresco / Share WAR (or
  *              exploded WAR folder)

plugins/alfresco-maven-plugin/src/main/java/org/alfresco/maven/plugin/VersionMojo.java

@@ -20,6 +20,7 @@ import org.apache.maven.project.MavenProject;
  * @goal set-version
  * @phase initialize
  * @requiresProject
+ * @since 1.0
  * @threadSafe
  * @description Parses Maven version and removes literals as not allowed in AMP versions, making a noSnapshotVersion property available for POM filtering
  */

pom.xml

@@ -9,6 +9,8 @@
     <description>This aggregator Project builds all modules required for the Maven Alfresco SDK</description>
     <packaging>pom</packaging>
     
+    <url>${maven.site.url}</url>
+    
     <prerequisites>
         <maven>3.0.3</maven>
     </prerequisites>
@@ -28,7 +30,7 @@
             <url>http://mindthegab.com</url>
             <organization>Alfresco Software</organization>
             <organizationUrl>http://www.alfresco.com</organizationUrl>
-            <timezone>GMT+1</timezone>
+            <timezone>+1</timezone>
             <roles>
                 <role>Founder</role>
                 <role>Architect</role>
@@ -42,7 +44,7 @@
             <url>http://session.it</url>
             <organization>Alfresco Software</organization>
             <organizationUrl>http://www.alfresco.com</organizationUrl>
-            <timezone>GMT+1</timezone>
+            <timezone>+1</timezone>
             <roles>
                 <role>Architect</role>
                 <role>Developer</role>
@@ -56,7 +58,7 @@
             <email>carlo@backbase.com</email>
             <organization>Backbase</organization>
             <organizationUrl>http://www.backbase.com</organizationUrl>
-            <timezone>GMT+1</timezone>
+            <timezone>+1</timezone>
             <url>http://skuro.tk</url>
         </contributor>
     </contributors>
@@ -84,10 +86,15 @@
             <url>https://artifacts.alfresco.com/nexus/content/repositories/snapshots
             </url>
         </snapshotRepository>
+        <site>
+            <id>alfresco-docs</id>
+            <url>dav:${maven.site.url}</url>
+        </site>
     </distributionManagement>
 
     <properties>
         <maven.archetype.version>2.2</maven.archetype.version>
+        <maven.site.url>https://artifacts.alfresco.com/nexus/content/repositories/alfresco-docs/maven-alfresco-sdk/latest</maven.site.url>
     </properties>
 
     <build>

src/changes/changes.xml

@@ -1,9 +1,21 @@
 <document>
   <properties>
-    <title>Maven Alfresco Lifecycle</title>
+    <title>Maven Alfresco SDK (former Maven Alfresco Lifecycle)</title>
     <author email="gabriele.columbro@alfresco.com">Gabriele Columbro</author>
   </properties>
   <body>
+    <release version="1.0" date="2012-11-03" description="Major feature release making the project to a fully fledged SDK, rebranded to Maven Alfresco SDK 1.0">
+        <action type="improvement">Complete re-write of alfresco-maven-plugin to embed Alfresco MMT, therefore maximize alignment / supportability of the build process</action>
+        <action type="add">Introduced a common SDK parent POM (alfresco-sdk-parent), single entry point to access SDK features</action>
+        <action type="add">Introduced a Alfresco platform distribution POM (alfresco-sdk-parent) describing Alfresco artifacts per every release</action>
+        <action type="add">Alfresco Artifacts Repository (https://artifacts.alfresco.com) now hosts Community and Enterprise artifacts with POMs</action>
+        <action type="update">Updated archetypes to provide samples to use the new SDK. An AMP and an All-in-One archetypes are available</action>
+        <action type="add">New support for customization / run of Repository, Share, Solr and Web Quick Start</action>
+        <action type="improvement">Support for rapid development with AMP unit testing and full embedded run and integration-test (NOTE: Jetty + H2 is NOT supported)</action>
+        <action type="improvement">Introduced a common SDK parent POM (alfresco-sdk-parent) to provide common SDK features</action>
+        <action type="update">Documentation clean up</action>
+        <action type="remove">Deprecated maven-amp-plugin and all old 3.9.1 maven-alfresco-* archetypes based on maven-amp-plugin</action>
+    </release>
     <release version="3.9.1" date="2012-04-06" description="Cleaned all defects in the framework and tested with 4.0b">
         <action dev="maurizio@session.it" type="fix">Fixed all existing defects to date in Google Code. See http://code.google.com/p/maven-alfresco-archetypes/issues/list?q=label:Milestone-Release391 for details</action>
         <action dev="columbro" type="update">Updated and released maven-alfresco-lifecycle and maven-alfresco-archetypes to version 3.9.1</action>

src/site/site.xml

@@ -8,12 +8,6 @@
         <fluidoSkin>
           <topBarEnabled>true</topBarEnabled>
           <sideBarEnabled>true</sideBarEnabled>
-          <topBarIcon>
-                  <name>Maven Alfresco Lifecycle</name>
-                  <alt>Maven Alfresco Lifecycle</alt>
-                  <src>/img/Alfresco-logo-transparent.gif</src>
-                  <href>/index.html</href>
-          </topBarIcon>
           <twitter>
                 <user>mindthegabz</user>
                 <showUser>true</showUser>
@@ -25,41 +19,39 @@
     </custom>
     <poweredBy>
         <logo name="Maven" href="http://maven.apache.org" img="http://maven.apache.org/images/logos/maven-feather.png" />
-		<logo name="Alfresco - Open source ECM" img="http://alfresco.com/assets/images/icons/powered_by_alfresco.gif"
+        <logo name="Alfresco Software" img="img/Alfresco-logo-transparent.gif"
             href="http://www.alfresco.com" />
     </poweredBy>
     <publishDate position="navigation-bottom" format="MM-dd-yy" />
-  <bannerLeft>
-    <name>Maven Alfresco Lifecycle - v. ${project.version}</name>
-    <href>http://www.alfresco.com</href>
-    <src>img/Alfresco-logo-transparent.gif</src>
-  </bannerLeft>
   
     <body>
-		<links>
-			<item name="Maven" href="http://maven.apache.org/" />
-			<item name="Alfresco" href="http://www.alfresco.com/" />
-			<item name="Project founder's blog" href="http://www.mindthegab.com/" />
-            <item name="Apache" href="http://www.apache.org/" />
-		</links>
 
         <menu ref="modules" inherit="bottom"/>
+        
         <menu ref="parent" inherit="bottom"/>
         
-		<menu name="Maven2 Lifecycle Alfresco Resources">
+        <menu name="SDK Resources">
-            <item name="Google Code Project" href="http://code.google.com/p/maven-alfresco-archetypes/" />
-			<item name="Alfresco Maven Wiki Docs" href="http://wiki.alfresco.com/wiki/Managing_Alfresco_Lifecyle_with_Maven" />
-            <item name="Alfresco with Maven for Dummies" href="https://wiki.alfresco.com/wiki/Maven_For_Dummies" />
-			<item name="Third party how to" href="http://www.cybermagic.co.nz/wiki/display/CM/Building+Alfresco+apps+with+Maven" />
-            <item name="Enterprise use case" href="http://www.slideshare.net/guest67a9ba/maven-application-lifecycle-management-for-alfresco" />
             <item name="FAQ" href="faq.html" />
-		</menu>
+            <item name="Alfresco SDK POM" href="https://artifacts.alfresco.com/nexus/content/repositories/alfresco-docs/alfresco-lifecycle-aggregator/latest/poms/alfresco-sdk-parent/index.html" />
-
+            <item name="Alfresco Platform Distribution POM" href="https://artifacts.alfresco.com/nexus/content/repositories/alfresco-docs/alfresco-platform-distribution/latest/index.html" />
-		<menu name="See also">
-			<item name="Maven Alfresco AMP Archetype" href="http://maven.alfresco.com/nexus/content/repositories/alfresco-docs/maven-alfresco-lifecycle/latest/maven-alfresco-archetype/maven-alfresco-amp-archetype/index.html" />
             <item name="Maven AMP Plugin" href="http://maven.alfresco.com/nexus/content/repositories/alfresco-docs/maven-alfresco-lifecycle/latest/plugins/maven-amp-plugin/index.html" />
         </menu>
         
+        <menu name="Maven Alfresco Community">
+            <item name="Alfresco Maven Wiki Docs" href="http://wiki.alfresco.com/wiki/Maven_Alfresco_SDK" />
+            <item name="Alfresco with Maven for Dummies" href="https://wiki.alfresco.com/wiki/Maven_For_Dummies" />
+            <item name="Developer Access (Google Code)" href="http://code.google.com/p/maven-alfresco-archetypes/" />
+            <item name="Gabriele Columbro's blog" href="http://www.mindthegab.com/" />
+            <item name="Maurizio Pillitu's blog" href="http://www.session.it/" />
+            <item name="Carlo Sciolla's blog" href="http://skuro.tk/" />
+            <item name="Enterprise adoption" href="http://www.slideshare.net/guest67a9ba/maven-application-lifecycle-management-for-alfresco" />
+        </menu>
+        
         <menu ref="reports" />
+        
+        <links>
+            <item name="Alfresco" href="http://www.alfresco.com/" />
+            <item name="Apache Maven" href="http://maven.apache.org/" />
+        </links>        
     </body>
 </project>