Éditer cette page

Le contenu de ce site est produit de manière collaborative et vous pouvez participer à son enrichissement. Contribuer ne nécessite pas de connaissances informatiques particulières même si nous utilisons GitHub une plate-forme qui ne vous est peut-être pas familière.

GitHub est un réseau social de partage de fichiers qui utilise un système de version qui s’appelle Git très utilisé en informatique. La plateforme permet d’organiser la collaboration sur des fichiers mais aussi de publier le site web du projet.

Sans connaissances approfondies de Git, il est facile de contribuer en suivant les indications ci-dessous.

Rejoindre l’organisation

Il n’est pas nécessaire de rejoindre l’équipe du projet pour contribuer mais c’est une bonne manière de participer au projet. Pour ce faire, vous devez créer un compte sur GitHub puis nous communiquer votre identifiant ici.

Participer aux discussions

La discussion concernant le projet et ses orientations utilise les issues de la plateforme GitHub. Les « issues » fonctionnent comme des sujets de discussion dans un forum. Vous pouvez débuter une discussion avec New issue ou bien consulter les discussions en cours et y répondre. Les issues de GitHub nous servent également à la gestion des tâches du projet.

En attendant des guides plus spécifiques sur l’organisation du projet, vous pouvez consulter les pages d’aide suivantes :

Rédiger des contenus

Vous pouvez proposer un sujet d’article avec une nouvelle issue (New issue). Tous les articles sont rédigés en plein texte avec la syntaxe Markdown, ce sont de simples fichiers textes.

Markdown est une syntaxe légère et facile à utiliser pour styler le texte. Parmi ces règles, on trouve les convention suivantes

Syntax highlighted code block

# Titre de niveau 1
## Titre de niveau 2
### Titre de niveau 3

- Liste à point
- item

1. Liste numérotée
2. item

Texte en **gras**, en _italique_ et `code`

[Lien](url) et ![Image](src)

Pour en savoir plus sur la syntaxe : GitHub Flavored Markdown.

Afin de créer un nouvel article ou corriger une page du projet, vous devez faire un fork du projet sur GitHub. Vous pouvez alors modifier la copie réalisée du répertoire directement dans l’interface de GitHub pour sur votre ordinateur si vous êtes à l’aise avec GitHub. Après avoir enregistré vos modifications avec un message de commit, vous pourrez proposer vos changement sous la forme d’un pull request.

Un guide pas-à-pas en français, sera bientôt publié. En attendant, vous pouvez consulter la page suivante :

  • https://www.oreilly.com/library/view/introducing-github/9781491949801/ch04.html

Vous pouvez par exemple suggérer des modifications en éditant cette page.

Ajouter un lien ou une référence

Pour la maintenance des liens, nous utilisons un groupe bibliographique Zotero, un gestionnaire de références bibliographiques libre et open source. N’hésitez pas à créer un compte et déjà collecter des références qui pourront être partagée dans le groupe.

Rejoignez le groupe Zotero : museadon