You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by jt...@apache.org on 2006/09/18 08:14:16 UTC

svn commit: r447273 - in /maven/plugins/trunk/maven-release-plugin: ./ src/site/ src/site/apt/ src/site/apt/examples/ src/site/fml/

Author: jtolentino
Date: Sun Sep 17 23:14:15 2006
New Revision: 447273

URL: http://svn.apache.org/viewvc?view=rev&rev=447273
Log:
PR: MRELEASE-141

Added:
    maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/
    maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/generate-release-poms.apt
    maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/lock-files.apt
    maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/perform-release.apt
    maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/prepare-release.apt
    maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/run-goals-before-commit.apt
    maven/plugins/trunk/maven-release-plugin/src/site/apt/index.apt
      - copied, changed from r447117, maven/plugins/trunk/maven-release-plugin/src/site/apt/introduction.apt
    maven/plugins/trunk/maven-release-plugin/src/site/apt/usage.apt
      - copied, changed from r447117, maven/plugins/trunk/maven-release-plugin/src/site/apt/howto.apt
    maven/plugins/trunk/maven-release-plugin/src/site/fml/
    maven/plugins/trunk/maven-release-plugin/src/site/fml/faq.fml
Removed:
    maven/plugins/trunk/maven-release-plugin/src/site/apt/howto.apt
    maven/plugins/trunk/maven-release-plugin/src/site/apt/introduction.apt
Modified:
    maven/plugins/trunk/maven-release-plugin/pom.xml
    maven/plugins/trunk/maven-release-plugin/src/site/site.xml

Modified: maven/plugins/trunk/maven-release-plugin/pom.xml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/pom.xml?view=diff&rev=447273&r1=447272&r2=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/pom.xml (original)
+++ maven/plugins/trunk/maven-release-plugin/pom.xml Sun Sep 17 23:14:15 2006
@@ -19,13 +19,16 @@
   <parent>
     <groupId>org.apache.maven.plugins</groupId>
     <artifactId>maven-plugins</artifactId>
-    <version>3</version>
+    <version>4-SNAPSHOT</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>maven-release-plugin</artifactId>
   <packaging>maven-plugin</packaging>
   <name>Maven Release plugin</name>
   <version>2.0-beta-5-SNAPSHOT</version>
+  <prerequisites>
+    <maven>2.0.1</maven>
+  </prerequisites>
   <issueManagement>
     <system>JIRA</system>
     <url>http://jira.codehaus.org/browse/MRELEASE</url>

Added: maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/generate-release-poms.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/generate-release-poms.apt?view=auto&rev=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/generate-release-poms.apt (added)
+++ maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/generate-release-poms.apt Sun Sep 17 23:14:15 2006
@@ -0,0 +1,44 @@
+  ------
+  Generate Release POMs
+  ------
+  Carlos Sanchez <ca...@apache.org>
+  Brett Porter <br...@apache.org>
+  John Tolentino <jt...@apache.org>
+  ------
+  September 18, 2006
+
+  ~~ Copyright 2006 The Apache Software Foundation.
+  ~~
+  ~~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~~ you may not use this file except in compliance with the License.
+  ~~ You may obtain a copy of the License at
+  ~~
+  ~~      http://www.apache.org/licenses/LICENSE-2.0
+  ~~
+  ~~ Unless required by applicable law or agreed to in writing, software
+  ~~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~~ See the License for the specific language governing permissions and
+  ~~ limitations under the License.
+
+  ~~ NOTE: For help with the syntax of this file, see:
+  ~~ http://maven.apache.org/guides/mini/guide-apt-format.html
+
+Generate Release POMs
+
+  To generate poms with resolved information (e.g. version numbers) to check the values the release plugin will use,
+  set the property generateReleasePoms to true. Resolved values will be saved in release-pom.xml
+
+-------
+mvn release:perform -DgenerateReleasePoms=true
+-------
+
+  This relies on <<<release.properties>>> being present from a previous release. If this is not the case, you need to
+  give the goal the name of the URL and optional tag to perform the release from. For example:
+
+-------
+mvn release:perform -DgenerateReleasePoms=true
+  -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0
+-------
+
+  After the release is complete, the <<<release.properties>>> and other release files will be removed from the checkout.
\ No newline at end of file

Added: maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/lock-files.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/lock-files.apt?view=auto&rev=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/lock-files.apt (added)
+++ maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/lock-files.apt Sun Sep 17 23:14:15 2006
@@ -0,0 +1,44 @@
+  ------
+  Lock Files During Release
+  ------
+  Carlos Sanchez <ca...@apache.org>
+  Brett Porter <br...@apache.org>
+  John Tolentino <jt...@apache.org>
+  ------
+  September 18, 2006
+
+  ~~ Copyright 2006 The Apache Software Foundation.
+  ~~
+  ~~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~~ you may not use this file except in compliance with the License.
+  ~~ You may obtain a copy of the License at
+  ~~
+  ~~      http://www.apache.org/licenses/LICENSE-2.0
+  ~~
+  ~~ Unless required by applicable law or agreed to in writing, software
+  ~~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~~ See the License for the specific language governing permissions and
+  ~~ limitations under the License.
+
+  ~~ NOTE: For help with the syntax of this file, see:
+  ~~ http://maven.apache.org/guides/mini/guide-apt-format.html
+
+Lock Files During Release
+
+  If you want to lock the files during release operation set the property useEditMode to true. Default value of this
+  property is false.
+
+-------
+mvn release:perform -DuseEditMode=true
+-------
+
+  This relies on <<<release.properties>>> being present from a previous release. If this is not the case, you need to
+  give the goal the name of the URL and optional tag to perform the release from. For example:
+
+-------
+mvn release:perform -DuseEditMode=true
+  -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0
+-------
+
+  After the release is complete, the <<<release.properties>>> and other release files will be removed from the checkout.
\ No newline at end of file

Added: maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/perform-release.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/perform-release.apt?view=auto&rev=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/perform-release.apt (added)
+++ maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/perform-release.apt Sun Sep 17 23:14:15 2006
@@ -0,0 +1,48 @@
+  ------
+  Perform a release
+  ------
+  Carlos Sanchez <ca...@apache.org>
+  Brett Porter <br...@apache.org>
+  John Tolentino <jt...@apache.org>
+  ------
+  September 18, 2006
+
+  ~~ Copyright 2006 The Apache Software Foundation.
+  ~~
+  ~~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~~ you may not use this file except in compliance with the License.
+  ~~ You may obtain a copy of the License at
+  ~~
+  ~~      http://www.apache.org/licenses/LICENSE-2.0
+  ~~
+  ~~ Unless required by applicable law or agreed to in writing, software
+  ~~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~~ See the License for the specific language governing permissions and
+  ~~ limitations under the License.
+
+  ~~ NOTE: For help with the syntax of this file, see:
+  ~~ http://maven.apache.org/guides/mini/guide-apt-format.html
+
+Perform a release
+
+  Performing a release does the following:
+
+   * Checkout from an SCM URL with optional tag
+
+   * Run the predefined maven goals to release the project (by default, <<<deploy site-deploy>>>)
+
+  To execute this step, run:
+
+-------
+mvn release:perform
+-------
+
+  This relies on <<<release.properties>>> being present from a previous release. If this is not the case, you need to
+  give the goal the name of the URL and optional tag to perform the release from. For example:
+
+-------
+mvn release:perform -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0
+-------
+
+  After the release is complete, the <<<release.properties>>> and other release files will be removed from the checkout.
\ No newline at end of file

Added: maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/prepare-release.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/prepare-release.apt?view=auto&rev=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/prepare-release.apt (added)
+++ maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/prepare-release.apt Sun Sep 17 23:14:15 2006
@@ -0,0 +1,69 @@
+  ------
+  Prepare a release
+  ------
+  Carlos Sanchez <ca...@apache.org>
+  Brett Porter <br...@apache.org>
+  John Tolentino <jt...@apache.org>
+  ------
+  September 18, 2006
+
+  ~~ Copyright 2006 The Apache Software Foundation.
+  ~~
+  ~~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~~ you may not use this file except in compliance with the License.
+  ~~ You may obtain a copy of the License at
+  ~~
+  ~~      http://www.apache.org/licenses/LICENSE-2.0
+  ~~
+  ~~ Unless required by applicable law or agreed to in writing, software
+  ~~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~~ See the License for the specific language governing permissions and
+  ~~ limitations under the License.
+
+  ~~ NOTE: For help with the syntax of this file, see:
+  ~~ http://maven.apache.org/guides/mini/guide-apt-format.html
+
+Prepare a release
+
+  Preparing a release executes the following steps:
+
+   * Check that there's no uncommitted changes in the sources
+
+   * Check that there's no SNAPSHOT dependencies
+
+   * Change the version in the poms from x-SNAPSHOT to a new version (you will be prompted for the versions to use)
+
+   * Transform the SCM information in the POM to the final destination of the tag
+
+   * Run the project tests against the modified POMs to confirm everything is in working order
+
+   * Commit the change of versions
+
+   * Tag the code in the SCM with a version name (this will be prompted for)
+
+   * Bump the version in the poms to a new value y-SNAPSHOT (these values are prompted also)
+
+   * Commit the change of versions
+
+  To execute this step, run:
+
+-------
+mvn release:prepare
+-------
+
+  <<Note:>> If an error occurs, or the process is cancelled, then running this will pick up from where the last one
+  left off from. If you wish to start again, use:
+
+-------
+mvn release:prepare -Dresume=false
+-------
+
+  Alternatively, you can use:
+
+-------
+mvn release:clean release:prepare
+-------
+
+  Note that if any changes have been made to your source files they might need to be reverted before you restart the
+  prepare process.

Added: maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/run-goals-before-commit.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/run-goals-before-commit.apt?view=auto&rev=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/run-goals-before-commit.apt (added)
+++ maven/plugins/trunk/maven-release-plugin/src/site/apt/examples/run-goals-before-commit.apt Sun Sep 17 23:14:15 2006
@@ -0,0 +1,54 @@
+  ------
+  Run Goals Before Commit
+  ------
+  Carlos Sanchez <ca...@apache.org>
+  Brett Porter <br...@apache.org>
+  John Tolentino <jt...@apache.org>
+  ------
+  September 18, 2006
+
+  ~~ Copyright 2006 The Apache Software Foundation.
+  ~~
+  ~~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~~ you may not use this file except in compliance with the License.
+  ~~ You may obtain a copy of the License at
+  ~~
+  ~~      http://www.apache.org/licenses/LICENSE-2.0
+  ~~
+  ~~ Unless required by applicable law or agreed to in writing, software
+  ~~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~~ See the License for the specific language governing permissions and
+  ~~ limitations under the License.
+
+  ~~ NOTE: For help with the syntax of this file, see:
+  ~~ http://maven.apache.org/guides/mini/guide-apt-format.html
+
+Run Goals Before Commit
+
+  To run additional goals after release preparation but before committing specify them using the preparationGoals
+  property.
+  
++-----
+<project>
+  [...]
+  <build>
+    [...]
+    <plugins>
+      [...]
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-release-plugin</artifactId>
+        <configuration>
+          <preparationGoals>
+            <preparationGoal>your-goal-here</preparationGoal>
+          </preparationGoals>
+        </configuration>
+      </plugin>
+      [...]
+    </plugins>
+    [...]
+  </build>
+  [...]
+</project>
++-----

Copied: maven/plugins/trunk/maven-release-plugin/src/site/apt/index.apt (from r447117, maven/plugins/trunk/maven-release-plugin/src/site/apt/introduction.apt)
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/src/site/apt/index.apt?view=diff&rev=447273&p1=maven/plugins/trunk/maven-release-plugin/src/site/apt/introduction.apt&r1=447117&p2=maven/plugins/trunk/maven-release-plugin/src/site/apt/index.apt&r2=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/src/site/apt/introduction.apt (original)
+++ maven/plugins/trunk/maven-release-plugin/src/site/apt/index.apt Sun Sep 17 23:14:15 2006
@@ -1,79 +1,52 @@
- ------
- Maven 2 Release Plugin 
- ------
- Carlos Sanchez <ca...@apache.org>
- Brett Porter <br...@apache.org>
- ------
- March 28, 2006
+  ------
+  Introduction
+  ------
+  Carlos Sanchez <ca...@apache.org>
+  Brett Porter <br...@apache.org>
+  John Tolentino <jt...@apache.org>
+  ------
+  September 18, 2006
 
-Introduction
+  ~~ Copyright 2006 The Apache Software Foundation.
+  ~~
+  ~~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~~ you may not use this file except in compliance with the License.
+  ~~ You may obtain a copy of the License at
+  ~~
+  ~~      http://www.apache.org/licenses/LICENSE-2.0
+  ~~
+  ~~ Unless required by applicable law or agreed to in writing, software
+  ~~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~~ See the License for the specific language governing permissions and
+  ~~ limitations under the License.
 
- This plugin is used to release a project with Maven, saving a lot of repetitive, manual work.
- Releasing a project takes two steps: prepare and perform.
+  ~~ NOTE: For help with the syntax of this file, see:
+  ~~ http://maven.apache.org/guides/mini/guide-apt-format.html
 
-* Prepare a release
+Maven Release Plugin
 
-  Preparing a release executes the following steps:
+  This plugin is used to release a project with Maven, saving a lot of repetitive, manual work.
+  Releasing a project takes two steps: prepare and perform.
 
-   * Check that there's no uncommitted changes in the sources
- 
-   * Check that there's no SNAPSHOT dependencies
- 
-   * Change the version in the poms from x-SNAPSHOT to a new version (you will be prompted for the versions to use)
+* Usage
 
-   * Transform the SCM information in the POM to the final destination of the tag
+  Instructions on how to use the Maven Release Plugin can be found {{{usage.html}here}}.
 
-   * Run the project tests against the modified POMs to confirm everything is in working order
+* Examples
 
-   * Commit the change of versions
- 
-   * Tag the code in the SCM with a version name (this will be prompted for)
- 
-   * Bump the version in the poms to a new value y-SNAPSHOT (these values are prompted also)
- 
-   * Commit the change of versions
+  To provide you with better understanding on some usages of the Maven Release Plugin,
+  you can take a look into the following examples:
 
-  To execute this step, run:
 
--------
-mvn release:prepare
--------
+  * {{{examples/perform-release.html}Perform Release}}
 
-  <<Note:>> If an error occurs, or the process is cancelled, then running this will pick up from where the last one
-  left off from. If you wish to start again, use:
+  * {{{examples/prepare-release.html}Prepare Release}}
 
--------
-mvn release:prepare -Dresume=false
--------
+  * {{{examples/generate-release-poms.html}Generate Release POMs}}
 
-  Alternatively, you can use:
+  * {{{examples/lock-files.html}Lock Files During Release}}
 
--------
-mvn release:clean release:prepare
--------
+  * {{{examples/run-goals-before-commit.html}Run Additional Goals Before Commit}}
 
-  Note that if any changes have been made to your source files they might need to be reverted before you restart the
-  prepare process.
 
-* Perform a release
-
-  Performing a release does the following:
-
-   * Checkout from an SCM URL with optional tag
- 
-   * Run the predefined maven goals to release the project (by default, <<<deploy site-deploy>>>)
-
-  To execute this step, run:
-
--------
-mvn release:perform
--------
-
-  This relies on <<<release.properties>>> being present from a previous release. If this is not the case, you need to
-  give the goal the name of the URL and optional tag to perform the release from. For example:
-
--------
-mvn release:perform -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0
--------
-
-  After the release is complete, the <<<release.properties>>> and other release files will be removed from the checkout.

Copied: maven/plugins/trunk/maven-release-plugin/src/site/apt/usage.apt (from r447117, maven/plugins/trunk/maven-release-plugin/src/site/apt/howto.apt)
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/src/site/apt/usage.apt?view=diff&rev=447273&p1=maven/plugins/trunk/maven-release-plugin/src/site/apt/howto.apt&r1=447117&p2=maven/plugins/trunk/maven-release-plugin/src/site/apt/usage.apt&r2=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/src/site/apt/howto.apt (original)
+++ maven/plugins/trunk/maven-release-plugin/src/site/apt/usage.apt Sun Sep 17 23:14:15 2006
@@ -1,12 +1,30 @@
- ------
- Maven 2 Release Plugin 
- ------
- Carlos Sanchez <ca...@apache.org>
- Brett Porter <br...@apache.org>
- ------
- March 28, 2006
+  ------
+  Usage
+  ------
+  Carlos Sanchez <ca...@apache.org>
+  Brett Porter <br...@apache.org>
+  John Tolentino <jt...@apache.org>
+  ------
+  September 18, 2006
+
+  ~~ Copyright 2006 The Apache Software Foundation.
+  ~~
+  ~~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~~ you may not use this file except in compliance with the License.
+  ~~ You may obtain a copy of the License at
+  ~~
+  ~~      http://www.apache.org/licenses/LICENSE-2.0
+  ~~
+  ~~ Unless required by applicable law or agreed to in writing, software
+  ~~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~~ See the License for the specific language governing permissions and
+  ~~ limitations under the License.
 
-How-to
+  ~~ NOTE: For help with the syntax of this file, see:
+  ~~ http://maven.apache.org/guides/mini/guide-apt-format.html
+
+Usage
 
   The following are some common scenarios in preparing a release.
 
@@ -24,7 +42,7 @@
   These example shows how to set the repository location for all tags to be created in Subversion.
   Note that it is not needed if you use the standard SVN layout, where the root project is in <<<trunk>>>, and
   there is a <<<tags>>> directory immediately above it.
- 
+
 -------------------
 <project>
     ...

Added: maven/plugins/trunk/maven-release-plugin/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/src/site/fml/faq.fml?view=auto&rev=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/src/site/fml/faq.fml (added)
+++ maven/plugins/trunk/maven-release-plugin/src/site/fml/faq.fml Sun Sep 17 23:14:15 2006
@@ -0,0 +1,28 @@
+<?xml version="1.0"?>
+
+<!--
+  ~ Copyright 2006 The Apache Software Foundation.
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+
+<faqs id="FAQ" title="Frequently Asked Questions">
+ <part id="General">
+   <faq id="versioning">
+     <question>Releasing from a parent pom, won't all its modules have the same release version and dev version as this parent?</question>
+     <answer>
+       <p>Maven Release Plugin will prompt for each project's version.</p>
+     </answer>
+   </faq>
+ </part>
+</faqs>
\ No newline at end of file

Modified: maven/plugins/trunk/maven-release-plugin/src/site/site.xml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-release-plugin/src/site/site.xml?view=diff&rev=447273&r1=447272&r2=447273
==============================================================================
--- maven/plugins/trunk/maven-release-plugin/src/site/site.xml (original)
+++ maven/plugins/trunk/maven-release-plugin/src/site/site.xml Sun Sep 17 23:14:15 2006
@@ -29,13 +29,24 @@
   </bannerRight>
   <body>
     <links>
-      <item name="Maven" href="http://maven.apache.org/"/>
+      <item name="Maven" href="http://maven.apache.org/maven2/"/>
     </links>
 
     <menu name="Overview">
-      <item name="Introduction" href="introduction.html"/>
-      <item name="How to Use" href="howto.html"/>
+      <item name="Introduction" href="index.html"/>
+      <item name="Goals" href="plugin-info.html"/>
+      <item name="Usage" href="usage.html"/>
+      <item name="FAQ" href="faq.html"/>
     </menu>
+
+    <menu name="Examples">
+      <item name="Perform Release" href="examples/perform-release.html"/>
+      <item name="Prepare Release" href="examples/prepare-release.html"/>
+      <item name="Generate Release POMs" href="examples/generate-release-poms.html"/>
+      <item name="Lock Files During Release" href="examples/lock-files.html"/>
+      <item name="Run Additional Goals Before Commit" href="examples/run-goals-before-commit.html"/>
+    </menu>
+
     ${reports}
   </body>
 </project>