Author: brett
Date: Thu Nov 2 23:53:33 2006
New Revision: 470706
URL: http://svn.apache.org/viewvc?view=rev&rev=470706
Log:
redesign front page and group documentation under the running, using, plugin,
repository and developer categories
Added:
maven/site/trunk/src/site/apt/maven-developers/
maven/site/trunk/src/site/apt/maven-developers/index.apt
maven/site/trunk/src/site/apt/plugin-developers/
maven/site/trunk/src/site/apt/plugin-developers/cookbook/
maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt
maven/site/trunk/src/site/apt/plugin-developers/index.apt
maven/site/trunk/src/site/apt/repository/
maven/site/trunk/src/site/apt/repository/index.apt
maven/site/trunk/src/site/apt/run-maven/
maven/site/trunk/src/site/apt/run-maven/cookbook/
maven/site/trunk/src/site/apt/run-maven/cookbook/index.apt
maven/site/trunk/src/site/apt/run-maven/index.apt
maven/site/trunk/src/site/apt/todo.apt
- copied unchanged from r470661,
maven/site/branches/brett-navigation-refactor/src/site/apt/todo.apt
maven/site/trunk/src/site/apt/users/
maven/site/trunk/src/site/apt/users/cookbook/
maven/site/trunk/src/site/apt/users/cookbook/index.apt
maven/site/trunk/src/site/apt/users/index.apt
maven/site/trunk/src/site/resources/images/archiva.png (with props)
maven/site/trunk/src/site/resources/images/continuum.png (with props)
maven/site/trunk/src/site/resources/images/folder-open.gif (with props)
Removed:
maven/site/trunk/src/site/apt/where-is-it.apt
Modified:
maven/site/trunk/src/site/apt/community.apt
maven/site/trunk/src/site/fml/project-faq.fml
maven/site/trunk/src/site/resources/css/site.css
maven/site/trunk/src/site/site.xml
maven/site/trunk/src/site/xdoc/index.xml
Modified: maven/site/trunk/src/site/apt/community.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/community.apt?view=diff&rev=470706&r1=470705&r2=470706
==============================================================================
--- maven/site/trunk/src/site/apt/community.apt (original)
+++ maven/site/trunk/src/site/apt/community.apt Thu Nov 2 23:53:33 2006
@@ -66,7 +66,8 @@
lots of bandwidth, please consider becomming a mirror for the Maven central
repository.
As you can imagine, thousands of users downloading can put quite a strain on
one server.
- If you wish to be a mirror, please make an announcement on the
{{{mailto:[EMAIL PROTECTED] User List}}.
+ If you wish to be a mirror, please file a request in the
{{{http://jira.codehaus.org/browse/MPA}Maven Project Administration}}
+ JIRA project.
** Host a Public Repository
@@ -80,9 +81,11 @@
** Mailing Lists
- The {{{mail-lists.html}Maven Mailing Lists}}. Specifically, the
{{{mailto:[EMAIL PROTECTED] User List}}.
+ Maven has a number of {{{mail-lists.html}Mailing Lists}}, and a the Maven
User List is specifically dedicated to
+ answering questions about all things Maven.
** IRC
- Log into the {{{http://irc.codehaus.org/}#maven IRC channel}} at
{{{http://codehaus.org/}Codehaus}}.
+ Log into the <<<#maven>>> IRC channel on <<<irc.codehaus.org>>>. If you
would like to access this over a web interface,
+ you can do so at {{http://irc.codehaus.org/}}.
Added: maven/site/trunk/src/site/apt/maven-developers/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/maven-developers/index.apt?view=auto&rev=470706
==============================================================================
--- maven/site/trunk/src/site/apt/maven-developers/index.apt (added)
+++ maven/site/trunk/src/site/apt/maven-developers/index.apt Thu Nov 2
23:53:33 2006
@@ -0,0 +1,20 @@
+ -----
+ Maven Developer Centre
+ -----
+ Brett Porter
+ -----
+ 3 November 2006
+ -----
+
+Maven Developer Centre
+
+ This documentation centre is for people who are Maven developers, or would
like to contribute.
+
+ <<COMING SOON!>>
+
+~~TODO: tasks as buttons?
+
+~~TODO: link to existing documents in community
+
+~~TODO: cookbook with more in depth documents like cutting releases, etc.
+
Added: maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt?view=auto&rev=470706
==============================================================================
--- maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt (added)
+++ maven/site/trunk/src/site/apt/plugin-developers/cookbook/index.apt Thu Nov
2 23:53:33 2006
@@ -0,0 +1,13 @@
+ -----
+ Plugin Cookbook
+ -----
+ Brett Porter
+ -----
+ 3 November 2006
+ -----
+
+Plugin Cookbook
+
+ <<COMING SOON!>>
+
+ <(Like to help write documentation? See
{{{../../guides/development/guide-helping.html} How to Contribute}})>
Added: maven/site/trunk/src/site/apt/plugin-developers/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/plugin-developers/index.apt?view=auto&rev=470706
==============================================================================
--- maven/site/trunk/src/site/apt/plugin-developers/index.apt (added)
+++ maven/site/trunk/src/site/apt/plugin-developers/index.apt Thu Nov 2
23:53:33 2006
@@ -0,0 +1,32 @@
+ -----
+ Plugin Developers Centre
+ -----
+ Brett Porter
+ -----
+ 3 November 2006
+ -----
+
+Plugin Developers Centre
+
+ This documentation centre is for those that are developing Maven plugins.
This might be for your own build, or as
+ an accompaniment to your third party tool.
+
+~~TODO: callout
+
+ <<What is a Mojo?>> A mojo is a <<M>>aven plain <<O>>ld <<J>>ava <<O>>bject.
Each mojo is an executable <goal> in
+ Maven, and a plugin is a distribution of one or more related mojos.
+
+~~TODO: tasks as buttons?
+
+ * {{{../guides/plugin/guide-java-plugin-development.html} Your First Mojo}}
- Learn how to write your first plugin
+
+ * {{{cookbook/index.html} Plugin Cookbook}} - Examples for how to perform
common tasks in plugins.
+
+~~TODO: trails
+
+* Reference
+
+ * {{{../developers/mojo-api-specification.html} Mojo API and Annotation
Reference}}
+
+ * {{{../ref/current/index.html} Maven API Reference}}
+
Added: maven/site/trunk/src/site/apt/repository/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/repository/index.apt?view=auto&rev=470706
==============================================================================
--- maven/site/trunk/src/site/apt/repository/index.apt (added)
+++ maven/site/trunk/src/site/apt/repository/index.apt Thu Nov 2 23:53:33 2006
@@ -0,0 +1,23 @@
+ -----
+ Repository Centre
+ -----
+ Brett Porter
+ -----
+ 3 November 2006
+ -----
+
+Maven Repository Centre
+
+ This documentation centre is for those that need to use or contribute to the
Maven repository. This includes those
+ that need dependencies for their own build, notice errors in the repository
metadata, or projects that wish to have
+ their releases added to the Maven repository.
+
+~~TODO: tasks as buttons?
+
+~~TODO: concepts
+
+ * {{{../project-faq.html} Maintaining your Metadata}} - Information for
third-party projects
+
+ * {{{../guides/mini/guide-maven-evangelism.html} Guide to Maven Evangelism}}
- Helping to improve the metadata of the dependencies you use
+
+~~TODO: more documents to link to here. Use the navigation cues (how to
upload, how to mirror, etc).
Added: maven/site/trunk/src/site/apt/run-maven/cookbook/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/run-maven/cookbook/index.apt?view=auto&rev=470706
==============================================================================
--- maven/site/trunk/src/site/apt/run-maven/cookbook/index.apt (added)
+++ maven/site/trunk/src/site/apt/run-maven/cookbook/index.apt Thu Nov 2
23:53:33 2006
@@ -0,0 +1,13 @@
+ -----
+ Build Cookbook
+ -----
+ Brett Porter
+ -----
+ 3 November 2006
+ -----
+
+Build Cookbook
+
+ <<COMING SOON!>>
+
+ <(Like to help write documentation? See
{{{../../guides/development/guide-helping.html} How to Contribute}})>
Added: maven/site/trunk/src/site/apt/run-maven/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/run-maven/index.apt?view=auto&rev=470706
==============================================================================
--- maven/site/trunk/src/site/apt/run-maven/index.apt (added)
+++ maven/site/trunk/src/site/apt/run-maven/index.apt Thu Nov 2 23:53:33 2006
@@ -0,0 +1,13 @@
+ -----
+ Build Cookbook
+ -----
+ Brett Porter
+ -----
+ 3 November 2006
+ -----
+
+Build Cookbook
+
+ <<COMING SOON!>>
+
+ <(Like to help write documentation? See
{{{../../guides/development/guide-helping.html} How to Contribute}})>
Added: maven/site/trunk/src/site/apt/users/cookbook/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/users/cookbook/index.apt?view=auto&rev=470706
==============================================================================
--- maven/site/trunk/src/site/apt/users/cookbook/index.apt (added)
+++ maven/site/trunk/src/site/apt/users/cookbook/index.apt Thu Nov 2 23:53:33
2006
@@ -0,0 +1,13 @@
+ -----
+ Build Cookbook
+ -----
+ Brett Porter
+ -----
+ 3 November 2006
+ -----
+
+Build Cookbook
+
+ <<COMING SOON!>>
+
+ <(Like to help write documentation? See
{{{../../guides/development/guide-helping.html} How to Contribute}})>
Added: maven/site/trunk/src/site/apt/users/index.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/users/index.apt?view=auto&rev=470706
==============================================================================
--- maven/site/trunk/src/site/apt/users/index.apt (added)
+++ maven/site/trunk/src/site/apt/users/index.apt Thu Nov 2 23:53:33 2006
@@ -0,0 +1,33 @@
+ -----
+ Users Centre
+ -----
+ Brett Porter
+ -----
+ 3 November 2006
+ -----
+
+Maven Users Centre
+
+ This documentation centre is for those that have decided to use Maven to
build their project, and would like to get
+ started quickly, or are already using Maven and would like to add new
functionality or fix a problem in their build.
+
+~~TODO: tasks as buttons?
+
+ * {{{../download.html} Download Maven}} - Download the latest version of
Maven
+
+ * {{{../getting-started/maven-in-five-minutes.html} The 5 minute test}} -
Learn how to use Maven in 5 minutes
+
+ * {{{../getting-started/index.html} Getting Started Tutorial}} - An in depth
tutorial once you've learned the basics
+
+ * {{{cookbook/index.html} Build Cookbook}} - Examples for how to add
functionality to your build
+
+~~TODO: old getting started guide should become a beginners trail, and remove
content covered in the 5 minute tutorial
+
+~~TODO: link to repository centre and plugin developers centre, and the
reasons why they would progress there
+
+* Reference
+
+ * {{{../pom.html} POM Reference}}
+
+ * {{{../settings.html} Settings Reference}}
+
Modified: maven/site/trunk/src/site/fml/project-faq.fml
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/fml/project-faq.fml?view=diff&rev=470706&r1=470705&r2=470706
==============================================================================
--- maven/site/trunk/src/site/fml/project-faq.fml (original)
+++ maven/site/trunk/src/site/fml/project-faq.fml Thu Nov 2 23:53:33 2006
@@ -40,7 +40,7 @@
<p>
It is best to get it right at the time of a release to avoid having
to make difficult updates later on.
Your information can be submitted to Maven using the regular
- <a
href="http://maven.apache.org/maven2/guides/mini/guide-ibiblio-upload.html";>repository
upload procedure</a>
+ <a href="guides/mini/guide-ibiblio-upload.html">repository upload
procedure</a>
.
</p>
<p>
Modified: maven/site/trunk/src/site/resources/css/site.css
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/resources/css/site.css?view=diff&rev=470706&r1=470705&r2=470706
==============================================================================
--- maven/site/trunk/src/site/resources/css/site.css (original)
+++ maven/site/trunk/src/site/resources/css/site.css Thu Nov 2 23:53:33 2006
@@ -9,10 +9,13 @@
#downloadbox {
float: right;
- margin: 0 1em 2em 2em;
- padding: 1em;
+ margin-left: 2em;
+ padding-left: 1em;
+ padding-right: 1em;
+ padding-bottom: 1em;
border: 1px solid #999;
background-color: #eee;
+ width: 17.5em;
}
#downloadbox h5 {
@@ -21,6 +24,7 @@
border-bottom: 1px solid #aaaaaa;
font-size: smaller;
padding: 0;
+ margin-top: 1em;
}
#downloadbox p {
@@ -28,13 +32,6 @@
margin-bottom: 0;
}
-#downloadbox ul {
- margin-top: 0;
- margin-bottom: 1em;
- list-style-type: disc;
+#downloadbox a {
+ white-space: nowrap;
}
-
-#downloadbox li {
- font-size: smaller;
-}
-
Added: maven/site/trunk/src/site/resources/images/archiva.png
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/resources/images/archiva.png?view=auto&rev=470706
==============================================================================
Binary file - no diff available.
Propchange: maven/site/trunk/src/site/resources/images/archiva.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: maven/site/trunk/src/site/resources/images/continuum.png
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/resources/images/continuum.png?view=auto&rev=470706
==============================================================================
Binary file - no diff available.
Propchange: maven/site/trunk/src/site/resources/images/continuum.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: maven/site/trunk/src/site/resources/images/folder-open.gif
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/resources/images/folder-open.gif?view=auto&rev=470706
==============================================================================
Binary file - no diff available.
Propchange: maven/site/trunk/src/site/resources/images/folder-open.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: maven/site/trunk/src/site/site.xml
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/site.xml?view=diff&rev=470706&r1=470705&r2=470706
==============================================================================
--- maven/site/trunk/src/site/site.xml (original)
+++ maven/site/trunk/src/site/site.xml Thu Nov 2 23:53:33 2006
@@ -1,5 +1,6 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<project name="Maven">
+ <!-- TODO: inherited publish, banner, skin -->
<bannerLeft>
<name>Maven</name>
<src>images/apache-maven-project-2.png</src>
@@ -8,23 +9,17 @@
<bannerRight>
<src>images/maven-logo-2.gif</src>
</bannerRight>
- <publishDate format="dd MMM yyyy" />
+ <publishDate format="dd MMM yyyy" position="right" />
<skin>
<groupId>org.apache.maven.skins</groupId>
<artifactId>maven-stylus-skin</artifactId>
</skin>
<body>
- <links>
+ <!-- TODO: inherited breadcrumbs, head, link menu -->
+ <breadcrumbs>
<item name="Apache" href="http://www.apache.org/"/>
- <item name="Maven 1.x" href="http://maven.apache.org/maven-1.x"/>
- <item name="Maven 2.x" href="http://maven.apache.org/"/>
- <item name="Archiva" href="http://maven.apache.org/archiva"/>
- <item name="Continuum" href="http://maven.apache.org/continuum"/>
- <item name="SCM" href="http://maven.apache.org/scm"/>
- <item name="Wagon" href="http://maven.apache.org/wagon"/>
- <item name="JXR" href="http://maven.apache.org/jxr"/>
- <item name="Doxia" href="http://maven.apache.org/doxia"/>
- </links>
+ <item name="Maven" href="http://maven.apache.org/"/>
+ </breadcrumbs>
<head>
<script src="http://www.google-analytics.com/urchin.js";
type="text/javascript">
@@ -35,18 +30,38 @@
</script>
</head>
+<!-- TODO: incorporate, remove, etc
+ <item name="General Information" href="/about.html"/>
+ <item name="For Maven 1.0 Users" href="/maven1.html"/>
+ <item name="For Other Projects" href="/project-faq.html"/>
+-->
+
<menu name="Get Maven">
<item name="Download" href="/download.html"/>
<item name="Release Notes" href="/release-notes.html"/>
- <item name="Tools">
- <item name="Eclipse Plug-in" href="/eclipse-plugin.html"/>
- <item name="Netbeans Module" href="/netbeans-module.html"/>
- </item>
+ <item name="License" href="/license.html"/>
+ </menu>
+
+ <menu name="IDE Integration">
+ <item name="Eclipse" href="/eclipse-plugin.html"/>
+ <item name="Netbeans" href="/netbeans-module.html"/>
+ </menu>
+
+ <!-- TODO: Candidate for chopping, or folding menu -->
+ <menu name="About Maven">
+ <item name="What is Maven?" href="/what-is-maven.html"/>
+ <item name="Features" href="/maven-features.html"/>
+ <item name="FAQ" href="/general.html"/> <!-- TODO: check this is for
non-users, not a technical FAQ -->
+<!--
+ <item name="Getting Support" href="todo.html" />
+-->
+ <item name="Powered By" href="/powered-by-m2.html"/>
</menu>
<menu name="Documentation">
- <item name="Quick Start" href="/quick.html" />
- <item name="User Guides">
+ <item name="Running Maven" href="/run-maven/index.html" />
+ <item name="User Centre" href="/users/index.html" collapse="true">
+ <item name="Maven in 5 Minutes"
href="/guides/getting-started/maven-in-five-minutes.html" />
<!-- item name="Concepts">
<item name="POM" href="/concepts.html#pom" />
<item name="Artifacts" href="/concepts.html#artifacts" />
@@ -59,54 +74,85 @@
<item name="Sites" href="/concepts.html#sites" />
<item name="Reports" href="/concepts.html#reports" />
</item -->
- <item name="Getting Started" href="/guides/getting-started/index.html"
/>
- <!-- item name="Build Cookbook" href="/" / -->
+ <!-- TODO: still needs splitting up -->
+ <item name="Getting Started Guide"
href="/guides/getting-started/index.html" />
+<!--
+ <item name="Trails">
+ <!- - TODO: some good trail ideas in John's proposal - need to go
back to email to get them. Trails might need to be a page rather than listed
here depending on quantity. Do we need to support more depth in navigation? - ->
+ <item name="Trail 1" href="todo.html" />
+ <item name="Trail 2" href="todo.html" />
+ </item>
+-->
+ <!-- TODO: make this a true, wiki based, commentable cookbook type
thingymabob -->
+ <item name="Build Cookbook" href="/examples/index.html"/>
+ <item name="Settings Reference" href="/settings.html" /> <!-- TODO:
all references should be collected under another area instead/as well,
reconsider -->
<item name="POM Reference" href="/pom.html" />
- <item name="Profiles Reference" href="/pom.html#Profiles" />
- <item name="Settings Reference" href="/settings.html" />
- <item name="Wiki" href="http://docs.codehaus.org/display/MAVENUSER"; />
- </item>
-
- <item name="Plugin Developer Guides">
+<!-- profiles.xml reference needed
+ <item name="Profiles Reference" href="todo.html" />
+-->
+ </item>
+ <item name="Plugin Developer Centre"
href="/plugin-developers/index.html" collapse="true">
+<!--
+ <item name="Plugin Concepts" href="todo.html" />
+-->
<item name="Your First Mojo"
href="/guides/plugin/guide-java-plugin-development.html" />
- <!-- item name="Plugin Cookbook" href="/" / -->
<item name="Mojo API" href="/developers/mojo-api-specification.html" />
- <!-- item name="Maven API" href="/" / -->
- </item>
-
- <item name="Plugins">
- <item name="By Category" href="/plugins/index.html" />
- <!-- item name="By Host" href="/" / -->
- <item name="Search" href="http://www.mvnrepository.com/"; />
- </item>
-
- <item name="Documentation Index">
- <item name="By Category" href="/guides/index.html" />
- <!-- item name="Alphabetical" href="/" / -->
- </item>
-
+<!--
+ <item name="Plugin Cookbook" href="todo.html" />
+-->
+ <item name="Maven API" href="/ref/current/index.html"/>
+ </item>
+ <item name="Maven Repository Centre" href="/repository/index.html"
collapse="true">
+<!-- TODO:
+ <item name="How to upload" href="/repository/upload.html" />
+ <item name="How to partner" href="/repository/partner.html" />
+ <item name="How to mirror" href="/repository/mirror.html" />
+-->
+ </item>
+ <item name="Maven Developer Centre" href="/maven-developers/index.html"
collapse="true">
+ <!-- TODO: under documentation? Review structure under here, aim for
consistency -->
+ <!-- TODO .... -->
+ <item name="Continuous Integration"
href="/continuous-integration.html"/>
+ </item>
+ <!-- TODO: improve categorisation -->
+ <item name="Index (category)" href="/guides/index.html" />
+<!--
+ <item name="Index (alphabetical)" href="todo.html" />
+-->
<item name="Books and Articles" href="/articles.html" />
+ <item name="Wiki" href="http://docs.codehaus.org/display/MAVENUSER"; />
+ </menu>
+
+ <menu name="Get Maven Plugins">
+<!--
+ <item name="By Host" href="todo.html" />
+-->
+ <item name="By Category" href="/plugins/index.html" />
+<!--
+ <item name="By Phase" href="todo.html" />
+-->
+ <!-- TODO: use the repository.maven.org plugin search, this doesn't seem
to have one -->
+ <!-- <item name="Search"
href="http://www.mvnrepository.com/plugins.html"; /> -->
</menu>
<menu name="Community">
<item name="Community Overview" href="/community.html"/>
<item name="How to Contribute"
href="/guides/development/guide-helping.html"/>
- <item name="Maven Repository">
- <item name="How to Help"
href="/guides/mini/guide-maven-evangelism.html" />
- <item name="Central Repo" href="http://repo1.maven.org/maven2/"; />
- <item name="Codehaus Repo" href="http://repository.codehaus.org/"; />
- </item>
+ <item name="Maven Repository"
href="/guides/mini/guide-maven-evangelism.html" />
<item name="Getting Support" href="/mail-lists.html" />
+ <item name="Issue Tracking" href="/issue-tracking.html" />
+ <item name="The Maven Team" href="/team-list.html" />
</menu>
- <menu name="About">
- <item name="What is Maven?" href="/what-is-maven.html"/>
- <item name="Features" href="/maven-features.html"/>
- <item name="FAQ" href="/general.html"/>
- <item name="Powered By" href="/powered-by-m2.html"/>
+ <menu name="Maven Projects" inherit="bottom">
+ <item name="Maven" href="http://maven.apache.org/"/>
+ <item name="Continuum" href="http://maven.apache.org/continuum"/>
+ <item name="Archiva" href="http://maven.apache.org/archiva"/>
+ <item name="SCM" href="http://maven.apache.org/scm"/>
+ <item name="Wagon" href="http://maven.apache.org/wagon"/>
+ <item name="JXR" href="http://maven.apache.org/jxr"/>
+ <item name="Doxia" href="http://maven.apache.org/doxia"/>
+ <item name="Maven 1.x" href="http://maven.apache.org/maven-1.x"/>
</menu>
-
-<!-- The "Project Documentation" section detracts from the Documentation above
-->
-<!-- ${reports} -->
</body>
</project>
Modified: maven/site/trunk/src/site/xdoc/index.xml
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/xdoc/index.xml?view=diff&rev=470706&r1=470705&r2=470706
==============================================================================
--- maven/site/trunk/src/site/xdoc/index.xml (original)
+++ maven/site/trunk/src/site/xdoc/index.xml Thu Nov 2 23:53:33 2006
@@ -5,133 +5,175 @@
<author email="[EMAIL PROTECTED]">Brett Porter</author>
</properties>
<body>
- <section name="Welcome to Maven">
- <div id="downloadbox">
- <h5>Get Maven 2.0.4</h5>
- <p>
- <a href="download.html">
- <img valign="top"
src="http://maven.apache.org/images/folder-open.gif"; border="0" alt=""
title="download"/>
- Download
- </a>
+ <!-- TODO: news? -->
+ <div id="downloadbox">
+ <h5>Get Maven 2.0.4</h5>
+ <span style="display: block; text-align: right; font-size:
smaller">Released: 10 April 2006</span>
+ <p>
+ <a href="download.html">
+ <img valign="top" src="images/folder-open.gif" border="0" alt=""
title="download"/>
Maven 2.0.4
- <small>(1.1Mb)</small>
- </p>
- <ul>
- <li>
- <a href="download.html#requirements">System Requirements</a>
- </li>
- <li>
- <a href="download.html#installation">Installation Instructions</a>
- </li>
- <li>
- <a href="release-notes.html">Release Notes</a>
- </li>
- <li>
- <a href="guides/getting-started/index.html">Getting Started</a>
- </li>
- <li>
- <a href="guides/index.html">Documentation</a>
- </li>
- </ul>
- <p>
- <a href="download.html">
- <img valign="top"
src="http://maven.apache.org/images/folder-open.gif"; border="0" alt=""
title="download"/>
- Download
- </a>
- Maven 2.0.4 Tasks for Ant
- <small>(870k)</small>
- </p>
- <ul>
- <li>
- <a href="/ant-tasks.html">Documentation</a>
- </li>
- </ul>
- </div>
+ </a>
+ <small>(1.1Mb)</small>
+ <span style="font-size: smaller">
+ <br/>
+ <a href="download.html#requirements">System Requirements</a>,
+ <a href="download.html#installation">Installation Instructions</a>,
+ <a href="release-notes.html">Release Notes</a>
+ </span>
+ </p>
+ <p>
+ <a href="download.html">
+ <img valign="top" src="images/folder-open.gif" border="0" alt=""
title="download"/>
+ Maven Tasks for Ant 2.0.4
+ </a>
+ <small>(870k)</small>
+ <span style="font-size: smaller">
+ <br/>
+ <!-- TODO: does this need to be in the Navigation? -->
+ <a href="ant-tasks.html">Documentation</a>
+ </span>
+ </p>
+ <!-- TODO: what about pointing to older releases? Maven 2.0.x (x < 4)
and Maven 1.x? -->
+ <!-- TODO: what about downloads for Continuum, etc.? Would be good to
have one big download page -->
+
+ <h5>Other Maven Projects</h5>
+ <p>
+ <a href="continuum">
+ <img src="images/continuum.png" border="0" width="76" height="32"
style="float: left; margin-right: 1em;"/>
+ Continuum
+ </a>
+ continuous integration server
+ </p>
+ <p>
+ <a href="archiva">
+ <img src="images/archiva.png" border="0" width="76" height="32"
style="float: left; margin-right: 1em;"/>
+ Archiva
+ </a>
+ repository and artifact management server
+ </p>
+ </div>
+ <section name="Welcome to Maven">
+
+ <!-- TODO: I reckon it's time for a new description -->
<p>
Maven is a software project management and comprehension tool. Based
on the concept of a project object model
(POM), Maven can manage a project's build, reporting and documentation
from a central piece of information.
</p>
<p>
- <h4>Maven Documentation</h4>
+ If you think that Maven could help your project, you can find out more
information about in the "About Maven"
+ section of the navigation. This includes an in-depth description of <a
href="what-is-maven.html">what Maven is</a>,
+ a <a href="maven-features.html">list of some of its main features</a>,
and a set of <a href="general.html">frequently
+ asked questions about what Maven is</a>.
</p>
+ <h3>Learning about Maven</h3>
<p>
- All the documentation for Maven is in the form of guides
- which can all be found <a href="guides/index.html">here</a>.
- </p>
- <p>
- <h4>About Maven 2.0</h4>
- </p>
- <p>
- Maven 2.0 is a rewrite of the popular Maven application to achieve a
number of goals, and to provide a stable
- basis to take it into the future.
+ <!-- TODO: this could be the big button type thing instead of a list
of links -->
+ This site is separated into the following sections, depending on how
you'd like to use Maven:
</p>
+ <!-- TODO: use CSS -->
<ul>
<li>
- <i>
- <a href="what-is-maven.html">What is Maven?</a>
- </i>
- </li>
- <li>
- <i>What are the
- <a href="maven-features.html">features of Maven 2.0</a>
- ?
- </i>
- </li>
- <li>
- <i>Where is the
- <a href="guides/index.html">Documentation</a>
- ?
- </i>
- </li>
- <li>
- <i>Tell me about the
- <a href="about.html#m2-goals">goals of Maven 2.0</a>
- </i>
- </li>
- <li>
- <i>Can I
- <a href="about.html#get-involved">get involved</a>
- ?
- </i>
- </li>
- <li>
- <i>Where do I
- <a href="about.html#get-help">get help</a>
- with Maven 2.0?
- </i>
+ <span style="white-space:nowrap; font-weight: bold; font-size:
1.25em">
+ <a href="run-maven/index.html">Run Maven</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those needing to build a project that uses Maven
+ </span>
+ </li>
+ <li>
+ <span style="white-space:nowrap; font-weight: bold; font-size:
1.25em">
+ <a href="users/index.html">Use Maven</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those wanting to use Maven to build their project,
including a "10 minute test" that gives a
+ practical overview of Maven's main features in just 10 minutes
+ </span>
+ </li>
+ <li>
+ <span style="white-space:nowrap; font-weight: bold; font-size:
1.25em">
+ <a href="plugin-developers/index.html">Write Maven Plugins</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those who may or may not be using Maven, but want
to provide a plugin for shared
+ functionality or to accompany their own product or toolset
+ </span>
+ </li>
+ <li>
+ <span style="white-space:nowrap; font-weight: bold; font-size:
1.25em">
+ <a href="repository/index.html">Improve the Maven Repository</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those who may or may not use, but are interested
in getting project metadata into the
+ repository
+ </span>
+ </li>
+ <li>
+ <span style="white-space:nowrap; font-weight: bold; font-size:
1.25em">
+ <a href="maven-developers/index.html">Develop Maven</a>
+ </span>
+ <span style="display: block; margin-bottom: 0.5em">
+ Information for those who are currently developers, or interested
in becoming developers of the Maven
+ project itself
+ </span>
</li>
</ul>
<p>
- <h4>Information for Maven 1.0 Users</h4>
+ Each guide is divided into a number of trails to get you started on a
particular topic, and includes a
+ reference area and a "cookbook" of common examples.
+ </p>
+ <p>
+ You can access the guides at any time from the left navigation.
+ </p>
+ <h3>Documentation Index</h3>
+ <p>
+ If you are looking for a quick reference, you can use the <a
href="guides/index.html">documentation index.</a>
+<!-- TODO
+ If you are looking for a quick reference, you can use the
documentation index. It is available in both
+ <a href="todo.html">alphabetical</a> and <a
href="todo.html">categorical</a> listing formats.
+-->
</p>
+ <h3>Plugins</h3>
+<!-- TODO
<p>
- Maven 1.0 users will likely have a lot of questions about Maven 2.0
and how it will impact the future of Maven
- 1.0.
+ Maven functionality is provided by plugins. For an explanation of how
plugins work, and basic information on how
+ to use a plugin, see the <a href="todo.html">introduction to
plugins</a> in the Users Centre.
+ </p>
+-->
+ <p>
+ For detailed information on just some of the plugins available for
Maven, see the
+ <a href="plugins/index.html">plugin list</a>.
+ </p>
+<!-- TODO: Should these be here, or just in the user centre?
+ <h3>Converting from a different Build System</h3>
+ <p>
+ If you are currently using a different build system, there are options
for converting from that to Maven 2
+ either partially or completely. These guides also give an overview of
the differences between Maven and the
+ other build system. The following guides are available in the Users
Centre:
</p>
<ul>
- <li>
- <i>
- <a href="maven1.html#">What's changed?</a>
- </i>
- </li>
- <li>
- <i>
- <a href="maven1.html#m1-or-m2">Should I use Maven 2.0, or Maven
1.0?</a>
- </i>
- </li>
- <li>
- <i>
- <a href="maven1.html#m1-future">What will happen</a>
- to Maven 1.0?
- </i>
- </li>
- <li>
- <i>Will my
- <a href="maven1.html#m1-plugins">Maven 1.0 plugins</a>
- be supported?
- </i>
- </li>
+ <li><a href="todo.html">Converting from Ant to Maven 2</a></li>
+ <li><a href="todo.html">Converting from Maven 1.x to Maven 2</a></li>
+ <li><a href="todo.html">Adding Maven 2 to an IDE based build</a></li>
</ul>
+-->
+ <h3>How to Get Support</h3>
+ <p>
+ Support for Maven is available in a variety of different forms.
+ </p>
+ <p>
+ To get started, search the documentation, the <a
href="http://docs.codehaus.org/display/MAVENUSER";>wiki</a>,
+ <a href="issue-tracking.html">issue tracker</a>, or the <a
href="mail-lists.html">mailing list archives</a> to
+ see if the problem has been solved or reported before.
+ </p>
+ <p>
+ If the problem has not been reported before, the recommended way to
get help is to
+ subscribe to the <a href="mail-lists.html">Maven Users Mailing
list</a>. Many other users and Maven developers
+ will answer your questions there, and the answer will be archived for
others in the future.
+ </p>
+ <p>
+ You can also reach the Maven developers on <a
href="community.html">IRC</a>.
+ </p>
</section>
</body>
</document>
![http://maven.apache.org/images/folder-open.gif"](http://maven.apache.org/images/folder-open.gif"){kind=link}