maven-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From br...@apache.org
Subject cvs commit: maven/xdocs/using index.xml repositories.xml
Date Thu, 02 Dec 2004 08:33:18 GMT
brett       2004/12/02 00:33:18

  Modified:    xdocs    index.xml navigation.xml
               xdocs/developers apache.xml releasing-plugins.xml
               xdocs/reference standard-sun-jar-names.xml
               xdocs/using repositories.xml
  Added:       xdocs/project components.xml
               xdocs/reference index.xml internal-repositories.xml
               xdocs/using index.xml
  Log:
  reformat the navigation
  
  Revision  Changes    Path
  1.18      +2 -2      maven/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/index.xml,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- index.xml	29 Nov 2004 06:58:54 -0000	1.17
  +++ index.xml	2 Dec 2004 08:33:17 -0000	1.18
  @@ -28,8 +28,8 @@
       <section name="Welcome to Maven">
         <p>
           Maven is a software project management and comprehension tool. Based on the concept
of a project object model
  -        (<a href="reference/glossary.html#POM">POM</a>), Maven can manage a
project's build, reporting and documentation from
  -        a central piece of information.
  +        (<a href="reference/glossary.html#POM">POM</a>), Maven can manage a
project's build, reporting and 
  +        documentation from a central piece of information.
         </p>
   
         <subsection name="Getting Started with Maven">
  
  
  
  1.55      +85 -77    maven/xdocs/navigation.xml
  
  Index: navigation.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/navigation.xml,v
  retrieving revision 1.54
  retrieving revision 1.55
  diff -u -r1.54 -r1.55
  --- navigation.xml	1 Dec 2004 11:46:45 -0000	1.54
  +++ navigation.xml	2 Dec 2004 08:33:17 -0000	1.55
  @@ -23,109 +23,117 @@
   
     <body>
       <links>
  -      <item name="Plugins"                        href="/reference/plugins/index.html"/>
  -      <item name="PDF Documentation"              href="/maven.pdf" img="/images/pdf.gif"/>
  +      <item name="Maven"                               href="/index.html"/>
  +      <item name="Plugins"                             href="/reference/plugins/index.html"/>
  +      <item name="Plugins Sandbox"                     /><!--href="/plugins-sandbox/index.html"/>-->
  +      <item name="SCM"                                 /><!-- href="/scm/index.html"
/> -->
  +      <item name="Wagon"                               /><!-- href="/wagon/index.html"
/> -->
  +      <item name="Components"                          href="/project/components.html"/>
  +      <item name="PDF Documentation"                   href="/maven.pdf" img="/images/pdf.gif"/>
       </links>
   
       <menu name="Getting Maven">
  -      <item name="Downloading"                    href="/start/download.html" />
  -      <item name="Installing"                     href="/start/install.html" />
  -      <item name="Release Notes"                  href="/start/release-notes-LATEST.html"
/>
  +      <item name="Downloading"                         href="/start/download.html" />
  +      <item name="Release Notes"                       href="/start/release-notes-LATEST.html"
/>
  +      <item name="Backwards Compatibility"             href="/reference/backwards-compatibility.html"
/>
       </menu>
   
       <menu name="Getting Started">
  -      <item name="Building a Project"             href="/start/quick-start.html" />
  -      <item name="Creating a Project"             href="/start/ten-minute-test.html"
/>
  -      <item name="Adapting a Project"             href="/start/adapting.html" />
  -      <item name="Maven for Ant Users"            href="/start/maven-for-ant-users.html"
/>
  +      <item name="Installing"                          href="/start/install.html" />
  +      <item name="Building a Project"                  href="/start/quick-start.html"
/>
  +      <item name="Creating a Project"                  href="/start/ten-minute-test.html"
/>
  +      <item name="Adapting a Project"                  href="/start/adapting.html" />
  +      <item name="Maven for Ant Users"                 href="/start/maven-for-ant-users.html"
/>
  +      <item name="FAQ"                                 href="/faq.html" />
       </menu>
   
       <menu name="About Maven">
  -      <item name="What is Maven?"                 href="/about/whatismaven.html" />
  -      <item name="Why use Maven?"                 href="/about/whymaven.html" />
  -      <item name="Feature Summary"                href="/about/features.html" />
  -      <item name="Powered by Maven"               href="/about/powered.html" />
  +      <item name="What is Maven?"                      href="/about/whatismaven.html"
/>
  +      <item name="Why use Maven?"                      href="/about/whymaven.html" />
  +      <item name="Feature Summary"                     href="/about/features.html" />
  +      <item name="Powered by Maven"                    href="/about/powered.html" />
       </menu>
   
       <menu name="News">
  -      <item name="Road Map"                       href="/roadmap.html" />
  -      <item name="Maven Blogs"                    href="http://www.mavenblogs.com/"
/>
  +      <item name="Road Map"                            href="/roadmap.html" />
  +      <item name="Articles and Press"                  href="/reference/articles.html"
/>
  +      <item name="Maven Blogs"                         href="http://www.mavenblogs.com/"
/>
       </menu>
       
  -    <menu name="Using Maven">
  -      <item name="Working with JARs"              href="/using/jar.html" />
  -      <item name="Working with Unit Tests"        href="/using/tests.html" />
  -      <item name="Working with Multiple Projects" href="/using/multiproject.html" />
  -      <item name="Building a Project Web Site"    href="/using/site.html" />
  -      <item name="Working with Web Applications"  href="/using/war.html" />
  -      <item name="Customising a Build"            href="/using/customising.html" />
  -      <item name="Making Releases"                href="/using/releasing.html" />
  -      <item name="Best Practices"                 href="/using/bestpractices.html" />
  -      <item name="Migrating from Ant"             href="/using/migrating.html" />
  -      <item name="FAQ"                            href="/faq.html" />
  -      <item name="Writing a Plugin"               href="/using/developing-plugins.html"
/>
  -      <item name="Working with Repositories"      href="/using/repositories.html" />
  -    </menu>
  -     
  -    <menu name="Reference">
  -      <item name="Glossary"                       href="/reference/glossary.html" />
  -      <item name="Conventions"                    href="/reference/conventions.html"
/>
  -      <item name="Project Descriptor"             href="/reference/project-descriptor.html"
/>
  -      <item name="Properties Reference"           href="/reference/properties.html"
/>
  -      <item name="Sharing Plugins"                href="/reference/sharing-plugins.html"
/>
  -      <item name="Uploading to Ibiblio"           href="/reference/repository-upload.html"
/>
  -      <item name="Backwards Compatibility Issues" href="/reference/backwards-compatibility.html"
/>
  -      <item name="Articles and Press"             href="/reference/articles.html" />
  -      <item name="Scripting"                      href="/reference/scripting.html" />
  -      <item name="Standard Sun JAR Names"         href="/reference/standard-sun-jar-names.html"
/>
  -      <item name="Command Line Reference"         href="/reference/command-line.html"
/>
  +    <!-- TODO [later]: clean up directory structure -->
  +    <menu name="User's Guide">
  +      <item name="Using Maven" collapse="true"         href="/using/index.html">
  +        <item name="Building JARs"                     href="/using/jar.html" />
  +        <item name="Unit Testing"                      href="/using/tests.html" />
  +        <item name="Web Applications"                  href="/using/war.html" />
  +        <item name="Creating a Site"                   href="/using/site.html" />
  +        <item name="Making Releases"                   href="/using/releasing.html"
/>
  +        <item name="Multiple Projects"                 href="/using/multiproject.html"
/>
  +        <item name="Migrating from Ant"                href="/using/migrating.html"
/>
  +        <item name="Best Practices"                    href="/using/bestpractices.html"
/>
  +      </item>
  +      <item name="Customising a Build" collapse="true" href="/using/customising.html">
  +        <item name="Scripting"                         href="/reference/scripting.html"
/>
  +        <item name="Writing a Plugin"                  href="/using/developing-plugins.html"
/>
  +        <item name="Sharing Plugins"                   href="/reference/sharing-plugins.html"
/>
  +      </item>
  +      <item name="Repositories" collapse="true"        href="/using/repositories.html">
  +        <item name="Internal Repositories"             href="/reference/internal-repositories.html"
/>
  +        <item name="Sun JAR Names"                     href="/reference/standard-sun-jar-names.html"
/>
  +        <item name="Uploading to Ibiblio"              href="/reference/repository-upload.html"
/>
  +      </item>
  +      <item name="Reference" collapse="true"           href="/reference/index.html">
  +        <item name="Glossary"                          href="/reference/glossary.html"
/>
  +        <item name="Conventions"                       href="/reference/conventions.html"
/>
  +        <item name="Project Descriptor"                href="/reference/project-descriptor.html"
/>
  +        <item name="Properties Reference"              href="/reference/properties.html"
/>
  +        <item name="Command Line"                      href="/reference/command-line.html"
/>
  +      </item>
       </menu>
   
  -<!-- TODO: Should references have an explanatory page? Eg summary about related projects,
summary about subprojects -->
  -    <menu name="The Maven Project">
  -      <item name="Maven"                          href="/" />
  +    <menu name="Getting Plugins">
   <!-- TODO: remove 3rd party bit from there, aggregate plugins to front page but add
explanation -->
  -      <item name="Maven Plugins"                  href="/reference/plugins/" />
  -<!-- TODO [later]: build sites
  -      <item name="Maven Plugin Sandbox"           href="/plugins-sandbox/" />
  -<!- - TODO [later]: later, this might just be part of a components menu instead - ->
  -      <item name="Maven Model Loader"             href="/components/maven-model/" />
  -      <item name="Maven Jelly Tags"               href="/jelly-tags/" />
  -      <item name="Maven Wagon"                    href="/wagon/" />
  -      <item name="Maven SCM"                      href="/scm/" />
  -<!- - TODO [later]: include PMC stuff - ->
  -      <item name="About the Project"              href="/tlp/" />
  --->
  +      <item name="Maven Plugins"                       href="/reference/plugins/index.html"
/>
  +      <item name="Maven Plugin Sandbox"               /><!-- href="/plugins-sandbox/index.html"
/> -->
  +      <item name="Maven Plugins @ sf.net"              href="http://maven-plugins.sf.net/"
/>
  +      <item name="Other 3rd Party Plugins"             href="/reference/3rdparty.html"
/>
  +    </menu>
  +
  +<!-- TODO: Should references have an explanatory page? Eg summary about related projects,
summary about subprojects -->
  +    <menu name="Maven Subprojects">
  +<!-- TODO [later]: include PMC stuff -->
  +      <item name="About the Project"                  /><!-- href="/tlp/index.html"
/> -->
  +<!-- TODO [later]: build sites -->
  +      <item name="Maven Wagon"                        /><!-- href="/wagon/index.html"
/> -->
  +      <item name="Maven SCM"                          /><!-- href="/scm/index.html"
/> -->
  +      <item name="Components" collapse="true"          href="/project/components.html">
  +        <item name="Maven Model Loader"                 /><!-- href="/components/maven-model/index.html"
/> -->
  +        <item name="Maven Jelly Tags"                   /><!-- href="/jelly-tags/index.html"
/> -->
  +      </item>
       </menu>
   
  -    <!-- TODO: check links -->
       <menu name="Related Projects">
  -<!-- TODO [later]: wait for a release
  -      <item name="Continuum"                      href="http://continuum.codehaus.org/"
/>
  --->
  -      <item name="Mevenide"                       href="http://mevenide.codehaus.org/"
/>
  -      <item name="Maven Proxy"                    href="http://maven-proxy.codehaus.org/"
/>
  -      <item name="Maven Plugins @ sf.net"         href="http://maven-plugins.sf.net/"
/>
  -      <item name="Other 3rd Party Plugins"        href="/reference/3rdparty.html" />
  -      <item name="Ant"                            href="http://ant.apache.org/"/>
  -      <item name="Jelly"                          href="http://jakarta.apache.org/commons/jelly/"/>
  -    </menu>
  -
  -<!-- TODO: contributing a better name? include submitting patches, JIRA, releasing plugins,
more foundation stuff, etc -->
  -<!-- TODO: on releasing plugins - document should be about versioning and releasing,
be a best practice? -->
  -    <menu name="Maven Developers">
  -      <item name="Building from Source"           href="/developers/building-from-source.html"
/>
  -      <item name="Apache Resources"               href="/developers/apache.html" />
  -      <item name="Releasing Plugins"              href="/developers/releasing-plugins.html"
/>
  -      <item name="Documentation Conventions"      href="/developers/documentation-conventions.html"
/>
  +<!-- TODO [later]: wait for a release -->
  +      <item name="Continuum"                          /><!-- href="http://continuum.codehaus.org/"
/> -->
  +      <item name="Mevenide"                            href="http://mevenide.codehaus.org/"
/>
  +      <item name="Maven Proxy"                         href="http://maven-proxy.codehaus.org/"
/>
  +      <item name="Ant"                                 href="http://ant.apache.org/"/>
  +      <item name="Jelly"                               href="http://jakarta.apache.org/commons/jelly/"/>
  +    </menu>
  +
  +<!-- TODO: contributing a better name? include submitting patches, etc -->
  +<!-- TODO [later]: actually, may want to fold up the whole top of the site when entering
the "developer section" -->
  +    <menu name="Developers" type="footer">
  +      <item name="Building from Source"                href="/developers/building-from-source.html"
/>
  +      <item name="Documenting"                         href="/developers/documentation-conventions.html"
/>
  +      <item name="Releasing Plugins"                   href="/developers/releasing-plugins.html"
/>
  +      <item name="Apache Resources"                    href="/developers/apache.html"
/>
       </menu>
       
   <!--
   TODO: plugin guides, how to find information... or do the standard tutorials introduce
this and each plugin just has its own set?
   TODO: overhaul development-process.xml and development directories
  -TODO: need more cohesiveness so nav is not needed? or need explanatory pages for each submenu
like before? trim the nav.
   TODO: talk about pom interpolation and pom inheritence, note that final values are interpolated
when inheriting
  -TODO: wrapping in navigation for "Web Applications", "Multiple Projects", etc.
   -->
     </body>
   </project>
  
  
  
  1.2       +1 -0      maven/xdocs/developers/apache.xml
  
  Index: apache.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/developers/apache.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- apache.xml	22 Nov 2004 11:52:58 -0000	1.1
  +++ apache.xml	2 Dec 2004 08:33:17 -0000	1.2
  @@ -29,6 +29,7 @@
         <p>
           The following are some resources available to Apache developers.
         </p>
  +<!-- TODO: more foundation stuff -->
         <ul>
           <li><a href="http://www.apache.org/dev/">Developer Resources</a></li>
           <li><a href="http://www.apache.org/dev/committers.html">Committer FAQ</a></li>
  
  
  
  1.2       +3 -0      maven/xdocs/developers/releasing-plugins.xml
  
  Index: releasing-plugins.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/developers/releasing-plugins.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- releasing-plugins.xml	22 Nov 2004 11:52:58 -0000	1.1
  +++ releasing-plugins.xml	2 Dec 2004 08:33:17 -0000	1.2
  @@ -22,6 +22,9 @@
       <title>Releasing Plugins</title>
       <author email="brett@apache.org">Brett Porter</author>
     </properties>
  +<!-- TODO: on releasing plugins - document should be about versioning and releasing,
be a best practice? 
  +  - this needs review currently.
  +  -->
     <body>
       <section name="Changing a Plugin">
       <p>
  
  
  
  1.1                  maven/xdocs/project/components.xml
  
  Index: components.xml
  ===================================================================
  <?xml version="1.0"?>
  <!--
  /*
   * Copyright 2001-2004 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.
   */
   -->
  
  <document>
  
    <properties>
      <title>Components</title>
      <author email="brett@apache.org">Brett Porter</author>
    </properties>
  
    <body>
      <section name="Components">
        <!-- TODO -->
        <p>...</p>
      </section>
    </body>
  </document>
  
  
  
  1.2       +1 -1      maven/xdocs/reference/standard-sun-jar-names.xml
  
  Index: standard-sun-jar-names.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/reference/standard-sun-jar-names.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- standard-sun-jar-names.xml	30 Nov 2004 08:34:15 -0000	1.1
  +++ standard-sun-jar-names.xml	2 Dec 2004 08:33:18 -0000	1.2
  @@ -26,7 +26,7 @@
   
     <body>
       <section name="Standard Sun JAR Names">
  -      <!-- TODOL list, and document reason -->
  +      <!-- TODO: list, and document reason, refer to sun-lic-journ -->
         <p>...</p>
       </section>
     </body>
  
  
  
  1.13      +10 -69    maven/xdocs/reference/index.xml
  
  
  
  
  1.1                  maven/xdocs/reference/internal-repositories.xml
  
  Index: internal-repositories.xml
  ===================================================================
  <?xml version="1.0"?>
  <!-- 
  /*
   * Copyright 2001-2004 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.
   */
   -->
  
  <document>
  
    <properties>
      <title>Internal Repositories</title>
      <author email="brett@apache.org">Brett Porter</author>
    </properties>
  
    <body>
  <!-- TODO -->
      <section name="Internal Repositories">
        <p>...</p>
      </section>
  
    </body>
  </document>
  
  
  
  1.3       +3 -2      maven/xdocs/using/repositories.xml
  
  Index: repositories.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/using/repositories.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- repositories.xml	29 Nov 2004 06:58:54 -0000	1.2
  +++ repositories.xml	2 Dec 2004 08:33:18 -0000	1.3
  @@ -20,13 +20,14 @@
   <document>
   
     <properties>
  -    <title>User Guide</title>
  +    <title>Repositories</title>
       <author email="jason@zenplex.com">Jason van Zyl</author>
  +    <author email="brett@apache.org">Brett Porter</author>
     </properties>
   
     <body>
   
  -<!-- TODO (NOT YET LINKED IN)
  +<!-- TODO
       <section name="Remote Repository Layout">
         <p>
           This document outlines the layout of Maven's remote repositories.
  
  
  
  1.1                  maven/xdocs/using/index.xml
  
  Index: index.xml
  ===================================================================
  <?xml version="1.0"?>
  <!--
  /*
   * Copyright 2001-2004 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.
   */
   -->
  
  <document>
  
    <properties>
      <title>Using Maven</title>
      <author email="brett@apache.org">Brett Porter</author>
    </properties>
  
    <body>
      <section name="Using Maven">
        <!-- TODO -->
        <p>...</p>
      </section>
    </body>
  </document>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org


Mime
View raw message