diff --git a/scripts/CONTRIB.md b/scripts/CONTRIB.md new file mode 100644 index 0000000..a7c5123 --- /dev/null +++ b/scripts/CONTRIB.md @@ -0,0 +1,45 @@ +# contribuer + +## quoi? + +contribuer n'est pas forcément participer au code, ce n'est pas qu'une affaire de _barbus_... + +cela demande de bien vouloir **partager**, ce qui se fait d'autant plus facilement que le sujet est **libre**, +**gratuit** et publié pour bénéficier à d'autres. + +ce partage est à la base, **un peu de temps** consacré à: + +* **reporter des bugs**, des incohérences. dans ce cas prendre le temps de faire un rapport clair et + compréhensible du problème rencontré, de tester et fournir des tests reproductibles +* **TESTER** puis reporter des soucis, des remarques ou des essais corrects +* apporter ses connaissances, dans le **code** ou **l'utilisation** ou un domaine particulier. + un développeur peut ne pas avoir tous les aspects en tête +* donner un avis, mais motivé, expliqué, en gardant en tête l'objectif de l'utilité potentielle à d'autres et + le rapport avantages/investissement en temps à développer une modification. On ne réclame pas, on cherche + à convaincre, ce qui participe aussi au développement de fonctionnalités, à adopter ou rejeter +* selon les projets, écrire de la doc, traduire, relire... + + +## [getInfo](https://kyodev.frama.io/kyopages/scripts/getInfo/) + +ce script à la base était destiné aux systèmes Debian. Quelques utilisateurs ayant testé sur d'autres +distributions, les modifications sont faites en fonction des tests rapportés. + +sont donc **bienvenus**: + +* des **testeurs** sur des **Linux** comme Arch Linux, Frugalware, Gentoo, Fedora et leurs dérivées. + * objectifs: analyser les comportements spécifiques +* des **connaisseurs** pour fournir les commandes utiles à la gestion des paquets propres à une famille de + de distributions **IMPORTANT** +* des **connaisseurs** pour fournir les trucs à tester pour améliorer un rapport de diagnostic +* des **connaisseurs** pour fournir les commandes "qui tuent" pour obtenir un résultat le plus portable + possible sur plusieurs distributions + + +## comment? + +Irc, Issues sur le [dépôt framagit](https://framagit.org/kyodev/kyopages/tree/master/scripts) sont les +moyens de base + +pour les _experts_, une plateforme comme framagit (gitlab) leur indique de suite d'autres outils possibles +(git/PR)