Garder la branche principale propre<\/h2>\n
Lorsque nous sommes administrateur un projet libre, il est toujours possible que quelqu’un veuille utiliser, compiler ou effectuer un \u00ab\u00a0fork\u00a0\u00bb du projet. Il est donc n\u00e9cessaire de toujours s’assurer d’avoir une branche principale (\u00ab\u00a0master\u00a0\u00bb ou \u00ab\u00a0main\u00a0\u00bb) fonctionnelle et stable. Lorsque vous faites des modifications substantielles au projet, assurez-vous de travailler dans une branche \u00e0 part et assurez-vous \u00e9galement de bien tester le projet avant d’effectuer la fusion (\u00ab\u00a0merge\u00a0\u00bb).<\/p>\n
Cr\u00e9er un fichier LISEZMOI<\/h2>\n
Un fichier lisezmoi (ou README) est un incontournable dans un projet libre. Il indique toutes les informations n\u00e9cessaires pour utilis\u00e9 ou pour participer au d\u00e9veloppement du logiciel. En g\u00e9n\u00e9ral, ce fichier contient: une description du projet, les auteurs, la licence, les proc\u00e9dures de compilation, l’information de d\u00e9veloppement (standard, environnement de test, etc.), la m\u00e9canique de report d’anomalie (bogue ou ajout de nouvelle fonctionnalit\u00e9), la fa\u00e7on de contacter les d\u00e9veloppeurs, etc.<\/p>\n
En g\u00e9n\u00e9ral, on utilise le langage Markdown<\/a> pour cr\u00e9er ce fichier.<\/p>\n Un ChangeLog est important afin de s’assurer que les d\u00e9veloppeurs qui participent au d\u00e9veloppement du logiciel puissent savoir ce qui a \u00e9t\u00e9 fait comme d\u00e9veloppement dans les diff\u00e9rentes versions du logiciel. \u00c7a peut leur permettre de bien g\u00e9rer leurs \u00ab\u00a0fork\u00a0\u00bb et \u00e9galement se tenir au courant de la progression du logiciel.<\/p>\n Ce ChangeLog peut \u00e9galement permettre aux utilisateurs du logiciel de savoir s’ils doivent absolument mettre \u00e0 jour leur logiciel dans les plus brefs d\u00e9lais (pour des mises \u00e0 jour de s\u00e9curit\u00e9 par exemple), ou bien s’ils peuvent attendre que le moment soit opportun pour eux de le faire (pour des ajouts de fonctionnalit\u00e9s par exemple).<\/p>\n Minimalement, un ChangeLog doit contenir les num\u00e9ros de version du logiciel ainsi que les modifications qui ont \u00e9t\u00e9 effectu\u00e9es. Sachez qu’il n’est pas n\u00e9cessaire d’\u00eatre tr\u00e8s pr\u00e9cis. Des informations comme \u00ab\u00a0Correction de plusieurs bogues\u00a0\u00bb ou bien \u00ab\u00a0Ajout de la fonctionnalit\u00e9 X\u00a0\u00bb sont des informations parfaitement valides dans un ChangeLog.<\/p>\n Afin que les utilisateurs du logiciel puissent informer les d\u00e9veloppeurs du projet lorsqu’ils trouvent des anomalies (bogues) ou lorsqu’ils pensent \u00e0 une nouvelle fonctionnalit\u00e9 qui serait int\u00e9ressante dans le logiciel, il est important de cr\u00e9er un rapporteur d’anomalies (ou \u00ab\u00a0issue list\u00a0\u00bb).<\/p>\n Un bon rapporteur d’anomalie doit \u00eatre enti\u00e8rement public (tous les usagers peuvent cr\u00e9er de nouveaux apports, sans \u00eatre membres du d\u00e9p\u00f4t Git). Il est g\u00e9n\u00e9ralement important d’avoir la possibilit\u00e9 de discuter sur les anomalies et les nouvelles fonctionnalit\u00e9s propos\u00e9es afin de savoir ce que la communaut\u00e9 du projet en pense. Certains syst\u00e8mes permettent \u00e9galement d’affecter certains d\u00e9veloppeurs aux anomalies ou nouvelles fonctionnalit\u00e9s inscrits dans le rapporteur d’anomalies.<\/p>\n Afin de s’assurer que le rapporteur d’anomalies ne se remplisse pas de simples questions, ou de discussion quelconque entourant le logiciel, il peut \u00eatre important de pr\u00e9voir une m\u00e9thode de discussion autre. Par exemple, plusieurs logiciels libres utilisent des listes de courriels (\u00ab\u00a0mailing list\u00a0\u00bb), d’autres utilisent des salons Matrix, d’autres utilisent des canaux IRC, etc. En g\u00e9n\u00e9ral, des syst\u00e8mes de communication utilisant des standards ouverts sont utilis\u00e9s, puisque plusieurs utilisateurs de logiciels libres ont cette pr\u00e9occupation \u00e0 coeur. Par exemple, si vous d\u00e9cidez que la communication du logiciel se fera avec Facebook, il se peut que plusieurs d\u00e9veloppeurs ne puissent pas participer aux discussions parce qu’ils ne voudront pas que leurs informations soient utilis\u00e9es dans un environnement ferm\u00e9 et propri\u00e9taire comme Facebook. Il est donc important de prendre cela en consid\u00e9ration afin de s’assurer d’avoir un maximum de participation au projet.<\/p>\n Enfin, une bonne pratique est de cr\u00e9er une suite de tests assez robuste afin et de cr\u00e9er un script d’int\u00e9gration continue qui fait qu’\u00e0 l’instant qu’une modification du projet sera envoy\u00e9e (\u00ab\u00a0push\u00a0\u00bb) sur le d\u00e9p\u00f4t Git (ou autre), ce script validera toutes les compilations et les tests du projet. Si une composante ne compile pas ou qu’un test ne se d\u00e9roule pas correctement, l’outil d’int\u00e9gration continue pourra avertir le d\u00e9veloppeur.<\/p>\n Cet outil est tr\u00e8s utile puisqu’il permet \u00e0 un d\u00e9veloppeur ayant effectu\u00e9 un \u00ab\u00a0fork\u00a0\u00bb de s’assurer que les modifications qu’il a faites n’a pas bris\u00e9 le logiciel avant d’effectuer un \u00ab\u00a0pull\/merge request\u00a0\u00bb. Donc, le d\u00e9veloppeur ayant effectu\u00e9 les modifications sauve du temps et le responsable du d\u00e9p\u00f4t officiel sauve du temps. C’est donc gagnant-gagnant pour tout le monde.<\/p>\n Retour<\/a><\/p>\n Auteur: Louis Marchand Introduction Lorsque nous avons un projet libre en t\u00eate, il est possible de le d\u00e9marrer. Voici quelques conseils afin de rendre ce projet accessible aux contributeurs et aux utilisateurs potentiels. Cr\u00e9er un d\u00e9p\u00f4t libre La premi\u00e8re \u00e9tape consiste g\u00e9n\u00e9ralement \u00e0 cr\u00e9er un d\u00e9p\u00f4t (Git ou autre) public et facilement accessible. L’utilisation de d\u00e9p\u00f4t personnel (sur… Continue reading Cr\u00e9er un projet libre<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-539","page","type-page","status-publish","hentry","entry"],"_links":{"self":[{"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/pages\/539","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/comments?post=539"}],"version-history":[{"count":10,"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/pages\/539\/revisions"}],"predecessor-version":[{"id":551,"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/pages\/539\/revisions\/551"}],"wp:attachment":[{"href":"https:\/\/www.louismarchand.me\/index.php\/wp-json\/wp\/v2\/media?parent=539"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Cr\u00e9er un ChangeLog<\/h2>\n
Utilisez un rapporteur d’anomalies (\u00ab\u00a0issue list\u00a0\u00bb)<\/h2>\n
Pr\u00e9voyez un syst\u00e8me de communication officielle pour le d\u00e9veloppement et le soutien<\/h2>\n
Utilisez des outils d’int\u00e9gration continue<\/h2>\n
\n
\n![\"Creative](\"https:\/\/i.creativecommons.org\/l\/by\/4.0\/80x15.png\")
<\/a>
\nSauf pour les sections sp\u00e9cifi\u00e9es autrement, ce travail est sous licence Creative Commons Attribution 4.0 International<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"