kyopages/scripts/CONTRIB.md

2.2 KiB

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

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 sont les moyens de base

pour les experts, une plateforme comme framagit (gitlab) leur indique de suite d'autres outils possibles (git/PR)