kyopages/scripts/CONTRIBUTING.md

53 lines
2.2 KiB
Markdown
Raw Normal View History

2017-11-12 09:22:18 +01:00
# contribuer
## quoi?
contribuer n'est pas forcément participer au code, ce n'est pas qu'une affaire de _barbus_...
2018-06-07 03:50:20 +02:00
cela demande de bien vouloir **partager**, ce qui se fait d'autant plus facilement que le sujet est **libre** et publié pour bénéficier à d'autres.
2017-11-12 09:22:18 +01:00
ce partage est à la base, **un peu de temps** consacré à:
2018-06-08 16:19:08 +02:00
* **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**, en n'oubliant que les développeurs ne sont pas derrière _votre_ écran et sont tellement focalisés ;) qu'ils faut les aider à comprendre votre remarque
* **TESTER**
reporter des soucis, des remarques ou des essais corrects
2017-11-12 09:22:18 +01:00
* apporter ses connaissances, dans le **code** ou **l'utilisation** ou un domaine particulier.
2018-06-08 16:19:08 +02:00
un développeur peut ne pas avoir tous les aspects en tête, n'a pas pas toutes les compétences. même s'il a des idées sur la question.
* donner un avis, **mais** motivé, expliqué, en gardant en tête l'objectif, l'utilité potentielle pour les autres et
le rapport avantages/investissement en temps de développement. On ne réclame pas, on cherche
2017-11-12 09:22:18 +01:00
à convaincre, ce qui participe aussi au développement de fonctionnalités, à adopter ou rejeter
2018-06-08 16:19:08 +02:00
2017-11-12 09:22:18 +01:00
* selon les projets, écrire de la doc, traduire, relire...
2018-06-08 16:19:08 +02:00
* bien-sur, les développeurs habitués n'ont rien à apprendre des Merge Requêtes
## getFirefox
ce script à la base était destiné aux systèmes Debian. Quelques utilisateurs ayant testé sur d'autres
2017-11-12 09:22:18 +01:00
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
2018-06-08 16:19:08 +02:00
2017-11-12 09:22:18 +01:00
* des **connaisseurs** pour fournir les commandes utiles à la gestion des paquets propres à une famille de
2018-06-07 18:18:23 +02:00
de distributions
2018-06-08 16:19:08 +02:00
2017-11-12 09:22:18 +01:00
* des **connaisseurs** pour fournir les commandes "qui tuent" pour obtenir un résultat le plus portable
possible sur plusieurs distributions
## comment?
2018-06-08 16:19:08 +02:00
moyens de bases:
* Irc: ##sdeb@freenode.net
* Issues sur le [dépôt framagit](https://framagit.org/kyodev/kyopages/issues)
2017-11-12 09:22:18 +01:00