[ 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