Skip to content

Latest commit

 

History

History
116 lines (76 loc) · 4.59 KB

CONTRIBUTING.md

File metadata and controls

116 lines (76 loc) · 4.59 KB

Contribuer

Avant de contribuer à ce dépôt, il est recommandé de discuter des changements que vous voulez apporter via les issues ou le Discord.

Règles de contribution

Organisation

  • Un sujet doit avoir son répertoire.
  • Plusieurs sujets peuvent être imbriqués, afin de traiter d'un sous-sujet.
  • Chaque répertoire, s'il contient un cours, doit contenir un fichier README.
  • Le fichier README doit toujours être présent et contenir une table des matières.
  • Chaque cours doit avoir un répertoire par langue, même si le cours n'est écrit que dans une langue.
  • Le nom d'un répertoire de langue doit être le code de ladite langue, par exemple fr ou en.
  • Chaque nom de fichier doit être écrit en UPPER_SNAKE_CASE et dans la langue correspondante (ex. CHAPITRE_1.md ou CHAPTER_1.md).
  • Si le cours est disponible pour plusieurs langues, il doit y avoir une table des matières pour chaque langue dans le fichier README.
  • Chaque entrée des tables des matières doit être un lien vers le fichier en question (et l'ancre s'il y en a une).

Des exemples sont disponibles pour illustrer ces règles.

Contenu des cours

Les cours peuvent porter sur n'importe quelle notion technique, et être écrits en n'importe quelle langue. Veillez à utiliser une orthographe correcte, peu importe la langue. Utilisez un correcteur si nécessaire.

Formatage

Cours

Les auteurs d'un cours doivent être mentionnés dans la seconde ligne du fichier README du cours, après le titre, sous le format suivant :

> Écrit par [<auteur>](https://github.com/<auteur>)

Remplacez <auteur> par le nom de l'auteur.

Commits

Vos commits peuvent être dans n'importe quel format, mais préferrez les commits conventionnels.

Pull-requests

Si le contenu du cours est en français, la pull-request doit être en français. Si le contenu du cours est dans n'importe quelle autre langue, la pull-request doit être en anglais.

Le titre d'une pull-request doit correspondre au format Ajout de chemin/vers/le/cours en français, ou Add chemin/vers/le/cours en anglais.

Par exemple, Ajout de poo/abstractions.

Processus de contribution

  1. Forkez le dépôt
  2. Clonez-le
  3. Créez une branche
    • Créez une branche par langue (ex. poo-abstractions-fr)
  4. Apportez vos modifications en suivant les règles de contribution
  5. Créez une pull request sur master
    • Veillez à effectuer une pull-request par langue et par cours
  6. Attendez une revue
  7. Si des changements sont demandés, effectuez-les, sinon, tout est bon.

Exemples

README

Voici un exemple de fichier README pour du contenu uniquement français

# Nom de la notion

Expliquez ce sur quoi porte le cours. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

## Table des matières

- Nom du premier chapitre - Nom d'un sous-chapitre - Nom d'un autre sous-chapitre
- Nom du second chapitre

Pour du contenu multi-langues, dupliquez le modèle ci-dessus, et traduisez-le.

# Titre de la notion 🇫🇷

Expliquez ce sur quoi porte le cours. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

## Table des matières

- Nom du premier chapitre - Nom d'un sous-chapitre - Nom d'un autre sous-chapitre
- Nom du second chapitre

--

# Notion's title 🇺🇸

Explain the course's contents. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

## Table of contents

- First chapter's name - Subchapter's name - Another subchapter's name
- Second chapter's name

Organisation

Voici un exemple de hiérachie des cours :

+ poo
	+ abstractions
		- README.md
		+ fr
			- CHAPITRE_1.md
			- CHAPITRE_2.md
		+ en
			- CHAPTER_1.md
			- CHAPTER_2.md