new CONTRIB

This commit is contained in:
kyodev 2017-11-12 09:22:18 +01:00
parent 7cba2b3b0a
commit 048e7dff63
1 changed files with 45 additions and 0 deletions

45
scripts/CONTRIB.md Normal file
View File

@ -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)