Avant de contribuer à ce dépôt, il est recommandé de discuter des changements que vous voulez apporter via les issues ou le Discord.
- 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
ouen
. - Chaque nom de fichier doit être écrit en
UPPER_SNAKE_CASE
et dans la langue correspondante (ex.CHAPITRE_1.md
ouCHAPTER_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.
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.
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.
Vos commits peuvent être dans n'importe quel format, mais préferrez les commits conventionnels.
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
.
- Forkez le dépôt
- Clonez-le
- Créez une branche
- Créez une branche par langue (ex.
poo-abstractions-fr
)
- Créez une branche par langue (ex.
- Apportez vos modifications en suivant les règles de contribution
- Créez une pull request sur
master
- Veillez à effectuer une pull-request par langue et par cours
- Attendez une revue
- Si des changements sont demandés, effectuez-les, sinon, tout est bon.
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
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