Le premier livre à traiter de Maven fut Maven: A Developer’s Notebook (O’Reilly). Ce livre introduisait Maven en plusieurs étapes via une conversation entre vous et un collègue qui savait déjà comment utiliser Maven. L'idée derrière la série des Developer’s Notebook (maintenant arrêtée) était que les développeurs apprennent mieux lorsqu'ils sont assis à côté d'autres développeurs et qu'ils passent par les mêmes schémas de pensée, apprenant à coder en réalisant et en expérimentant. Même si cette série fut un succès, le format Cahier avait des limitations. Les Cahiers du Développeur sont, par essence, des livres "avec un but précis" qui vous font passer par une série d'étapes pour atteindre des buts très spécifiques. Au contraire, les gros livres de reférence (les livres avec un animal chez O’Reilly) apportent un matériel de référence qui couvre un sujet dans son entier.

Si vous lisez Maven: A Developer’s Notebook, vous apprendrez comment créer un projet simple ou un projet qui construit un WAR à partir de fichiers source. Mais si vous voulez comprendre les spécificités d'un point particulier comme le plugin Assembly, vous vous retrouverez dans une impasse. Comme il n'existe pas de matériel de référence correctement écrit sur Maven, vous devrez partir à la chasse dans la documentation des plugins sur le site de Maven ou fouiller les listes de diffusion. Une fois que vous vous êtes réellement plongé dans Maven, vous avez dû lire des milliers de pages HTML sur le site de Maven écrites par des centaines de développeurs différents, chacun avec sa propre idée de ce que doit contenir la documentation d'un plugin. Malgré les efforts de contributeurs de bonne volonté, lire la documentation des plugins sur le site de Maven est au mieux frustrant, et au pire, suffisamment décourageant pour abandonner Maven. Assez souvent, les utilisateurs de Maven restent bloqués car ils ne trouvent pas de réponse.

Cette absence d'un manuel de référence (voire ultime) a bloqué Maven pendant quelques années, et a été un frein à son adoption. Avec Maven: The Definitive Guide, nous avons l'intention de changer tout ça en fournissant une référence complète dans la Partie II, « Maven - La Reference ». Dans la Partie I, nous avons conservé la progression narrative d'un Cahier du Développeur ; elle est intéressante car elle permet d'apprendre Maven par l'exemple. Dans cette partie nous "introduisons en faisant", et dans la Partie II, « Maven - La Reference », nous comblons les manques et nous nous plongeons dans les détails. Là où la Partie II, « Maven - La Reference » pourrait utiliser un tableau de référence et un listing de programme déconnecté d'un projet exemple, la Partie II est animée par de véritables exemples.

Après avoir lu cette partie, vous devriez en savoir suffisamment pour commencer à utiliser Maven. Vous auriez besoin de vous référer à la Partie II, « Maven - La Reference » uniquement lorsque vous commencer à personnaliser Maven en écrivant vos propres plugins ou si vous voulez plus de détails sur un plugin particulier.