Sommaire

Présentation des rapports avec Maven 3

1. Introduction

Dans le développement logiciel, la gestion de la documentation en général est une donnée primordiale à la maintenance, au suivi et à l’évolution d’un projet.

La Documentationdocumentation a été abordée succinctement dans le chapitre précédent comme une composante de la livraison d’un projet. Apache Maven gère principalement cette documentation sous forme de Rapportsrapports au format HTML. Elle fait donc partie intégrante de Maven, notamment lors du processus de Release présenté ultérieurement puisque le goal release:perform est configuré par défaut pour déployer le site web du projet lors de la fin de son traitement.

2. Les éléments du POM

La philosophie d’Apache Maven 3 reste la même concernant la documentation puisqu’elle est dédiée à un composant externe sous forme de plugin : le maven-site-pluginmaven-site-plugin. Les éléments du POM qui sont utilisés pour la génération des rapports web et le déploiement du site web sont les suivants :

<project> 
 ... 
 <url>http://...</url> 
 ... 
 < distributionManagementdistributionManagement> 
     ...  
     < sitesite>...</site> 
  ...