You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by hb...@apache.org on 2017/11/17 08:08:28 UTC

svn commit: r1815554 - in /maven/site/trunk/content: apt/guides/introduction/introduction-to-plugins.apt apt/guides/plugin/guide-java-plugin-development.apt apt/plugin-developers/index.apt site.xml xdoc/developers/mojo-api-specification.xml

Author: hboutemy
Date: Fri Nov 17 08:08:28 2017
New Revision: 1815554

URL: http://svn.apache.org/viewvc?rev=1815554&view=rev
Log:
reworked introduction to plugins development in plugin developers center

Modified:
    maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt
    maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt
    maven/site/trunk/content/apt/plugin-developers/index.apt
    maven/site/trunk/content/site.xml
    maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml

Modified: maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt (original)
+++ maven/site/trunk/content/apt/guides/introduction/introduction-to-plugins.apt Fri Nov 17 08:08:28 2017
@@ -1,5 +1,5 @@
  ------
- Introduction to Maven 2.0 Plugin Development
+ Introduction to Maven Plugin Development
  ------
  John Casey
  ------
@@ -26,7 +26,7 @@
 ~~ NOTE: For help with the syntax of this file, see:
 ~~ http://maven.apache.org/doxia/references/apt-format.html
 
-Introduction to Maven 2.0 Plugin Development
+Introduction to Maven Plugin Development
 
   Maven consists of a core engine which provides basic project-processing
   capabilities and build-process management, and a host of plugins which are
@@ -48,10 +48,10 @@ Introduction to Maven 2.0 Plugin Develop
   can be customized through a set of unique parameters which are exposed by a
   description of each plugin goal (or Mojo).
 
-  One of the simplest plugins in Maven 2.0 is the Clean Plugin.  The
+  One of the simplest plugins in Maven is the Clean Plugin.  The
   {{{../../plugins/maven-clean-plugin/}Maven
   Clean plugin}} (maven-clean-plugin) is responsible for removing the target
-  directory of a Maven 2 project.  When you run "mvn clean", Maven 2 executes
+  directory of a Maven project.  When you run "mvn clean", Maven executes
   the "clean" goal as defined in the Clean plug-in, and the target directory
   is removed.  The Clean plugin
   {{{../../plugins/maven-clean-plugin/clean-mojo.html}defines
@@ -60,12 +60,15 @@ Introduction to Maven 2.0 Plugin Develop
 
 * What is a Mojo (<And Why the H--- is it Named 'Mojo'>)?
 
-  A Mojo is really just a goal in Maven 2, and plug-ins consist of
+  A Mojo is really just a goal in Maven, and plug-ins consist of
   any number of goals (Mojos).  Mojos can be defined as annotated Java classes or
   Beanshell script.  A Mojo specifies
   metadata about a goal: a goal name, which phase of the lifecycle it fits into,
   and the parameters it is expecting.
 
+  Mojo term was introduced in Maven 2 as a complete rework on how to write plugins
+  (see below for more details on Maven 1.x plugins comparison).
+
   MOJO is a play on POJO (Plain-old-Java-object), substituting "Maven" for
   "Plain".  Mojo is also an iteresting word (see {{{http://www.answers.com/mojo&r=67}definition}}).
   From {{{http://www.wikipedia.org}Wikipedia}}, a "mojo" is defined as:
@@ -81,7 +84,7 @@ Introduction to Maven 2.0 Plugin Develop
 
 Resources
 
-    [[1]] {{{../plugin/guide-java-plugin-development.html}Plugin development guide}}
+    [[1]] {{{/plugin-developers/index.html}Plugin Development Center}}
 
     [[2]] {{{../mini/guide-configuring-plugins.html}Configuring plugins}}
 

Modified: maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt (original)
+++ maven/site/trunk/content/apt/guides/plugin/guide-java-plugin-development.apt Fri Nov 17 08:08:28 2017
@@ -177,7 +177,7 @@ public class GreetingMojo extends Abstra
 *-------------+----------------------------------------------------+
 |<<<compile>>>|Compiles the Java code for the plugin               |
 *-------------+----------------------------------------------------+
-|<<<process-classes>>>|Extracts data to build the plugin descriptor|
+|<<<process-classes>>>|Extracts data to build the {{{/ref/current/maven-plugin-api/plugin.html}plugin descriptor}}|
 *-------------+----------------------------------------------------+
 |<<<test>>>   |Runs the plugin's unit tests                        |
 *-------------+----------------------------------------------------+

Modified: maven/site/trunk/content/apt/plugin-developers/index.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/apt/plugin-developers/index.apt?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/apt/plugin-developers/index.apt (original)
+++ maven/site/trunk/content/apt/plugin-developers/index.apt Fri Nov 17 08:08:28 2017
@@ -38,6 +38,8 @@ Plugin Developers Centre
 
 ~~TODO: tasks as buttons?
 
+  * {{{../guides/introduction/introduction-to-plugins.html} Introduction to Plugin Development}} - Introduction to concepts
+
   * {{{../guides/plugin/guide-java-plugin-development.html} Your First Mojo}} - Learn how to write your first plugin
 
   * {{{./plugin-testing.html} Testing your Plugin}} - How to write tests for your plugins

Modified: maven/site/trunk/content/site.xml
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/site.xml?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/site.xml (original)
+++ maven/site/trunk/content/site.xml Fri Nov 17 08:08:28 2017
@@ -82,6 +82,7 @@ under the License.
         <item name="POM Reference" href="/pom.html" />
       </item>
       <item name="Plugin Developer Centre" href="/plugin-developers/index.html" collapse="true">
+        <item name="Introduction to Plugin Development" href="/guides/introduction/introduction-to-plugins.html" />
         <item name="Your First Mojo" href="/guides/plugin/guide-java-plugin-development.html" />
         <item name="Mojo API" href="/developers/mojo-api-specification.html" />
         <item name="Maven API" href="/ref/current/index.html"/>

Modified: maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml
URL: http://svn.apache.org/viewvc/maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml?rev=1815554&r1=1815553&r2=1815554&view=diff
==============================================================================
--- maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml (original)
+++ maven/site/trunk/content/xdoc/developers/mojo-api-specification.xml Fri Nov 17 08:08:28 2017
@@ -855,7 +855,7 @@ under the License.
           ]
         </li>
         <li>Plexus Project (Plexus container) [
-          <a href="https://github.com/sonatype/plexus-containers/">link</a>
+          <a href="https://codehaus-plexus.github.io/">link</a>
           ]
         </li>
         <li>Maven Plugin API [