Salut, J'ai commencé la mise à jour de la doc (uniquement la française) des mavenpom. Le site est en ligne. Eric, tu peux aussi regarder le pom de vradi (et demander à Jean qui a quelques billes que je lui ai donné). Je devrais l'avoir fini demain. A vos remarques :) -- Tony Chemit -------------------- tél: +33 (0) 2 40 50 29 28 email: chemit@codelutin.com http://www.codelutin.com
Le Thu, 21 Jan 2010 21:50:38 +0100, Tony Chemit <chemit@codelutin.com> a écrit :
Salut,
J'ai commencé la mise à jour de la doc (uniquement la française) des mavenpom.
Le site est en ligne.
Eric, tu peux aussi regarder le pom de vradi (et demander à Jean qui a quelques billes que je lui ai donné).
Je devrais l'avoir fini demain.
A vos remarques :)
J'ai ajouté la page Utilisation (Usage) avec un pom fonctionnel sur mavenpom4redmine et mavenpom4labs. Pour moi la doc doit être ok, mais je peux pas être objectif vu que je le connais par coeur :) Donc again, à vos remarques :) -- Tony Chemit -------------------- tél: +33 (0) 2 40 50 29 28 email: chemit@codelutin.com http://www.codelutin.com
Tony Chemit wrote:
Donc again, à vos remarques :)
J'avais pas encore regardé, mais maintenant c'est done :D. Mes remarques concernent la doc mais aussi mavenpom en général (ou la compréhension que j'en ai a travers la doc). J'ai essayé d'être exaustif et super chiant, de pointer partout où c'est pas clair. J'espère que ça va t'aider :D. Divers : - les liens depuis les pages d'accueil vers les pages profiles et propriétés ne fonctionnent pas. Mavenpom : - Propriétés : * divers : la valeur par défaut est pas tout le temps renseignée * platform semble dépendant de redmine devrait pas plutot être dans mavenpom4redmine ? * projectId semble dépendant de redmine aussi plutot dans mavenpom4redmine ? * repository.home.url : ça serait pas plutot l'url du dépot maven de déploiement qui est par défaut le dépot maven de nuiton ? * defaultLocale : pas très clair l'explication * scmwebeditorUrl : expliquer ce que c'est, on est pas obligés d'être de code pour utiliser le mavenpom (ex:labs). * maven.reports.dependencyLocationsEnabled : en français on dit localisation * jrst.version : revoir la phrase de Note * skin.version : pas très clair, à revoir. Peut-être un lien vers les skins... - Profiles : * local-webstart-profile : déploiement et non déployement * update-java-header et update-jaxx-header ça fait quoi exactement sur les entêtes. Faut rien rajouter de plus ? Lien vers le plugin p-e ? * pourquoi c'est pratique par rapport à un non multi-module, à expliquer. * internal : déploiement et non déployement * internalRedminePreRelease : on parle de redmine, pourquoi pas dans mavenpom4redmine ? Je sais Ce profile ne doit être utiliser uniquement que pour le projet *mavenpom* mais du coup peut-être le renommer * internalRedmineRelease : même remarque. - Effectuer une release : * déploiement et pas deployment * annonces et non announces * diverses fautes d'orthographe -Maven best practices : * page pas terminée, mi-anglais mi-français :D - A faire : * En a-t-on besoin vu qu'on a les tickets sur redmine ? Mavenpom4labs : - Accueil : * propriétés obligatoires : lab.id. Il est où ? Où est-ce que je le trouve ? - Propriétés : * platform : à quoi ça sert ? le labs c'est le labs on n'a pas besoin de le changer si on se sert de mavenpom4labs. * labs.id : Il est où ? Où est-ce que je le trouve ? * labs.list.host : idem, ça change jamais ça. * Ajouter un lien vers la page des propriétés de mavenpom - Profiles * labs-pre-release-profile : Ce profile permet suite à une release de publier la release sur redmine ? on est pas sur le labs ? Idem : confirmer l'exécution des commandes sur le serveur redmine. * labs-release-profile : Ce profile permet suite à une release de publier la release sur redmine ? On est pas sur le labs ? * labs-next-version-profile : Ce profile permet de créer la version sur le serveur redmine ? On est pas sur le labs ? - Utilisation * Organization : mettre autre chose que Jurismarchés * developers : project et non porject * packaging : pom ne sert qu'en multi-module non ? - Faire une release * A développer. En lisant les profiles je me disait qu'il fallait justement une page comme ça. - Réorganisation menu * je pense qu'il faudrait réorganiser un peu le menu de la manière suivante : $ Inside mavenpom4labs (p-e un titre en français, même si celui là colle magnifiquement) $ Utiliser mavenpom4labs ø Pom minimal ø Faire une release avec mavenpom4labs $ Développer mavenpom4labs (Développeur fait trop référence à la doc dev de mavenpom4labs et pas assez à la doc utilisateur. Même si tu es dev tu es utilisateur de mavenpom4labs :D) Mavenpom4redmine : - Accueil * RAS - Propriétés * divers : mettre les termes anglais entre ' ' ex : 'issues', lien vers la page des propriétés de mavenpom. * redmine.serverId : settings.xml * redmine.projectId : c'est quoi c'est id ? Je le trouve où ? * redmine.xmlPath : pourquoi ? expliquer comment traite les issues. * redmine.collectedAttachments : fichier générer ou a rédiger soit même * redmine.collectedArtifacts : idem * redmine.libReleaseFiles : comment ça marche ? j'ai rien compris. Pourquoi ça se sert de la propriété redmine.releaseFiles ? - Profiles * redmine-build-release-profile : quels fichiers à publier, un exemple serait bien. - Utilisation * commentaires en anglais, peut-être mieux en français. * packaging : maven-plugin ? * if documentation is not only in french, use this * if documentation is not in rst, use this - Faire une release * Nickel génial, juste quelques fautes d'orthographe, mais on comprend tout :D * Peut-être expliquer dans l'abstract qu'ainsi on fait la release normale et qu'on manipule directement les releases,... sur redmine et que du coup on fait rien à la mano et que du coup c'est trop bien :D. - Réorganisation menu (pareil que pour mavenpom4labs). * je pense qu'il faudrait réorganiser un peu le menu de la manière suivante : $ Inside mavenpom4redmine $ Utiliser mavenpom4redmine ø Pom minimal ø Faire une release avec mavenpom4redmine $ Développer mavenpom4redmine
Tony Chemit wrote:
Donc again, à vos remarques :)
Une nouvelle remarque, vu que j'ai voulu améliorer le pom d'episodesmanager en suivant tes conseils : - On sait pas quels plugins sont actifs dans mavenpom et ses fils, et du coup on sait pas lesquels il faut redéclarer dans un projet utilisant mavenpom (ou alors j'ai pas trouvé :D). Je sais pas si c'est clair ce que je raconte, du coup un exemple : j'utilises jaxx, du coup dans mon plugin management, il faut que je déclare le maven-jaxx-plugin ou il est déjà déclaré dans mavenpom, idem pour eugene, topia, license-plugin, helper-plugin, i18n-plugin,... - Idem pour les dépendances en fait.
Le Sat, 23 Jan 2010 12:33:45 +0100, Jean Couteau <couteau@codelutin.com> a écrit :
Tony Chemit wrote:
Donc again, à vos remarques :)
Une nouvelle remarque, vu que j'ai voulu améliorer le pom d'episodesmanager en suivant tes conseils :
- On sait pas quels plugins sont actifs dans mavenpom et ses fils, et du coup on sait pas lesquels il faut redéclarer dans un projet utilisant mavenpom (ou alors j'ai pas trouvé :D). Je sais pas si c'est clair ce que je raconte, du coup un exemple :
j'utilises jaxx, du coup dans mon plugin management, il faut que je déclare le maven-jaxx-plugin ou il est déjà déclaré dans mavenpom, idem pour eugene, topia, license-plugin, helper-plugin, i18n-plugin,...
- Idem pour les dépendances en fait.
zut, j'ai créé une section là dessus dans la doc :) [1] section les plugins configurés En gros, si c'est un plugin externe (pas de chez code) il doit être dans le mavenpom Sinon tu dois complètement le gérer dans ton pom, donc dans ton cas (JAXX) c'est un plugin interne donc c'est à toi de le gérer. Par contre pour les dépendances, tu dois tout gérer par toi même, mavenpom ne s'occupant que des plugins. [1] http://maven-site.nuiton.org/mavenpom/index.html -- Tony Chemit -------------------- tél: +33 (0) 2 40 50 29 28 email: chemit@codelutin.com http://www.codelutin.com
Le Sat, 23 Jan 2010 13:36:59 +0100, Tony Chemit <chemit@codelutin.com> a écrit :
Le Sat, 23 Jan 2010 12:33:45 +0100, Jean Couteau <couteau@codelutin.com> a écrit :
Tony Chemit wrote:
Donc again, à vos remarques :)
Une nouvelle remarque, vu que j'ai voulu améliorer le pom d'episodesmanager en suivant tes conseils :
- On sait pas quels plugins sont actifs dans mavenpom et ses fils, et du coup on sait pas lesquels il faut redéclarer dans un projet utilisant mavenpom (ou alors j'ai pas trouvé :D). Je sais pas si c'est clair ce que je raconte, du coup un exemple :
j'utilises jaxx, du coup dans mon plugin management, il faut que je déclare le maven-jaxx-plugin ou il est déjà déclaré dans mavenpom, idem pour eugene, topia, license-plugin, helper-plugin, i18n-plugin,...
- Idem pour les dépendances en fait.
zut, j'ai créé une section là dessus dans la doc :) [1] section les plugins configurés
En gros, si c'est un plugin externe (pas de chez code) il doit être dans le mavenpom
Sinon tu dois complètement le gérer dans ton pom, donc dans ton cas (JAXX) c'est un plugin interne donc c'est à toi de le gérer.
Avec une exception pour maven-helper-pluign, maven-license-plugin et maven-jredmine-plugin qui font partie du process de release (ou des profiles)...
Par contre pour les dépendances, tu dois tout gérer par toi même, mavenpom ne s'occupant que des plugins.
-- Tony Chemit -------------------- tél: +33 (0) 2 40 50 29 28 email: chemit@codelutin.com http://www.codelutin.com
participants (2)
-
Jean Couteau -
Tony Chemit