[ http://jira.codehaus.org/browse/MNG-2143?page=comments#action_60685 ] 

Raphaël Piéroni commented on MNG-2143:
--------------------------------------

I think the first part of the refactor task should be to find the categories.
Here are the categories i saw:

Archetypes
Testing
 This category includes unit testing and integration testing
Maven tools
 For talking about the other programs like the ant tasts and the repository 
manager
Maven extension development
 For creating plugins and archetypes
Generating sources
Site
 This is for the project developer site with sub categories
 Quality for reports like PMD, checkstyle, surefire, ...
 Documentation for reports like javadoc, jxr, ...
 Information for reports like mailing list, issue trasker, ...
Ide
 For using maven in an ide
Deployments
  For deploying artifacts into repositories, application servers
Associated artifacts
 For creating and attaching some associated artifacts like sources, javadoc, ...
Packagings
 For talking about alternative packagings like war, ear, ...
Alternative languages
 For using maven with other languages like c#, aspecjt, ...
Continuous integration
 For using maven with a continuous integration system

Then  we should put guides and plugins into the categories.
Some plugins may belong into more than one category.

We also need some basic documentation for talking about 
theorical concepts like packagings, repositories, ...

Then write the site...

> Proposition of documentation
> ----------------------------
>
>          Key: MNG-2143
>          URL: http://jira.codehaus.org/browse/MNG-2143
>      Project: Maven 2
>         Type: Improvement

>   Components: Documentation:  General
>     Reporter: Raphaël Piéroni
>  Attachments: AdvancedDocumentation.apt, MainPage.apt
>
>
> Here attached are 2 apt file that describe a first attempt to refactor the 
> maven documentation site.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira

Reply via email to