Skip to content

Latest commit

 

History

History
61 lines (40 loc) · 3.84 KB

README.md

File metadata and controls

61 lines (40 loc) · 3.84 KB
Raw

karibou-papers 🔥

Karibou.ch est un projet participatif. Son but est de développer une nouvelle manière de distribuer l'alimentation. Cette forme passe par une participation active des acteurs de l'alimentation. Le logiciel karibou.ch ainsi que la charte participe à la cohésion du réseau.

karibouCore Logo

DOCUMENT LIEN STATUS
README Fr,En en cours
translate Fr/En en cours
CG Fr,En en cours
La charte Fr,En en cours
Les buts de la PAVE Fr,En en cours
Comment ça marche Fr,En en cours
La philosophie Fr,En en cours
Qui sommes nous? Fr,En en cours

Comment nous aider?

  1. Chaque document doit être disponible en français et anglais,
  2. «La charte» doit être élaborée de manière participative afin de lui donner un maximum de sens. Seul les acteurs directs de l'alimentation (producteurs, transformateurs, et commerçants) sont abilités à voter sur une modification

Comment participer?

La manière la plus simple pour modifier un document:

  1. Vous devez avoir un compte github
  2. Si vous êtes producteurs, transformateurs, et commerçants de karibou.ch vous pourrez faire partie de l'équipe de validation des modifications (il faut nous demander par email)
  3. Cliquez un-fichier-à-éditer.md et sur le bouton edit en haut à droite
  4. Quand vous avez terminé votre travail, il faut cliquer en bas sur le bouton vert Propose file change
  5. Nous serons informés de votre demande de modification

Qu'est-ce github et le social coding

GitHub est platfeorme qui permet d'herberger les sources d'un projet. Mais surtout github est centré vers l'aspect social du développement, il permet à des équipes réparties dans le monde entier de collaborer. Pour rendre cette collaboration possible, il suffit de suivre quelques règles de base.

  1. Github permet de copier un projet sur son compte; c'est ce qu'on appelle un fork
  2. Une fois copié, le projet peut être modifié à volonté.
  3. On peut ensuite demander à la source du projet d'accepter des modifications; c'est ce qu'on appelle un «pull request»
  4. Chaque demande de modification (PR) est revue et commentée avant d'être acceptée par le propriétaire du projet.
  5. Un projet copié peut aussi se développer par lui même

Qu'est-ce qu'un Pull Request (PR)

Github propose une manière démocratique très puissante pour que chacun puisse participer à des projets. Pour participer, il faut effectuer au moins une modification à un projet. Chaque demande de modification est soumise au vote/débat avant d'être acceptée par les propriétaires du projet. C'est ce qu'on appelle un Pull Request (PR). Lorsque le fichier à modifier est sensible, on peut demander un quorum minimal de personnes pour valider et intégrer une proposition.

Pour utiliser ce processus, la manière la plus simple c'est de suivre l'exemple suivant. Une fois votre modification terminée, vous allez cliquer sur Propose file change en bas, et le logiciel vous proposera de créer un Create pull request qu'il faut accepter. image

Il faut ajouter une description qui explique le but de la modification. On trouve toute les demandes de modification ici La première est un exemple.

Authors