GITBOOK-5: edit the community discord

Author: geoffreylgv

intro-oss/.gitbook/assets/introoss (1).png

@@ -0,0 +1,9 @@
+---
+description: Une introduction au monde du logiciel libre et le buzzword 'Open Source'.
+---
+
+# Introduction à l'open source
+
+<figure><img src=".gitbook/assets/introoss (1).png" alt=""><figcaption></figcaption></figure>
+
+Credit : [OpenSauced](https://github.com/OpenSource-Communities/intro), Geoffrey Logovi's contribution ; check [License](https://github.com/OpenSource-Communities/intro/blob/main/LICENSE.txt)

intro-oss/.gitbook/assets/introoss.png

@@ -0,0 +1,13 @@
+# Table of contents
+
+* [Introduction à l'open source](README.md)
+  * [Prérequis](introduction-a-lopen-source/prerequis.md)
+  * [Introduction](introduction-a-lopen-source/introduction.md)
+  * [Qu'est-ce que l'Open Source ?](introduction-a-lopen-source/quest-ce-que-lopen-source.md)
+  * [Pourquoi l'Open Source ?](introduction-a-lopen-source/pourquoi-lopen-source.md)
+  * [Outils pour réussir](introduction-a-lopen-source/outils-pour-reussir.md)
+  * [Comment contribuer à l'open source](introduction-a-lopen-source/comment-contribuer-a-lopen-source.md)
+  * [La sauce secrète](introduction-a-lopen-source/la-sauce-secrete.md)
+  * [Les types de contributions à l'Open Source](introduction-a-lopen-source/les-types-de-contributions-a-lopen-source.md)
+  * [Conclusion](introduction-a-lopen-source/conclusion.md)
+  * [Glossaire](introduction-a-lopen-source/glossaire.md)

intro-oss/.gitbook/assets/mod.png

@@ -0,0 +1,29 @@
+# Conclusion
+
+Pour conclure ce cours sur les débuts de l'open source, récapitulons les principaux enseignements et discutons de la suite de votre parcours dans l'open source.
+
+### A retenir
+
+Tout au long de ce cours, nous avons abordé une série de sujets destinés à vous aider à comprendre et à naviguer dans le monde de l'open source :
+
+1. **Qu'est-ce que l'open source ?** : Nous avons discuté de la définition de l'open source, de son histoire et des principes fondamentaux qui guident le mouvement open source.
+2. **Pourquoi l'open source ?** : Nous avons étudié les avantages de participer à des projets open source, notamment l'accès à la connaissance, la communauté et le développement des compétences.
+3. **Les outils pour réussir** : Nous avons présenté les outils et les plateformes essentiels pour les contributeurs de l'open source, tels que GitHub, Git, CodeSee, Visual Studio Code et Discord.
+4. **Comment contribuer à l'open source** : Nous avons discuté du processus de recherche de projets sur lesquels travailler, de la soumission de contributions, de l'intégration dans de nouveaux projets et de ce qui se passe après la soumission de votre contribution.
+5. **La sauce secrète** : Nous avons partagé des stratégies pour commencer à contribuer à l'open source, pour gagner du terrain dans vos contributions et pour développer votre CV open source.
+
+En comprenant ces concepts et en appliquant les stratégies que nous avons évoquées, vous serez bien équipé pour vous lancer avec succès dans l'aventure de l'open source.
+
+### Quelle est la prochaine étape ?
+
+Avec les connaissances et les outils que vous avez acquis dans ce cours, vous êtes prêt à plonger dans le monde de l'open source et à commencer à apporter des contributions significatives. Voici les prochaines étapes qui vous aideront à poursuivre votre voyage dans le monde de l'open source:
+
+1. **Identifiez vos intérêts et vos objectifs** : Avant de commencer à contribuer à des projets open source, prenez le temps de réfléchir à vos intérêts, à vos passions et à vos objectifs. Cela vous aidera à identifier les projets qui correspondent à vos valeurs et à vos objectifs.
+2. **Trouvez des projets auxquels contribuer** : Utilisez des plateformes telles que GitHub, CodeTriage, etc. pour découvrir des projets open source qui correspondent à vos intérêts et à vos compétences. Recherchez des projets avec des communautés actives, une documentation claire et des directives de contribution bien définies.
+3. **Commencez à contribuer** : Une fois que vous avez identifié un projet auquel contribuer, commencez par vous attaquer à de petites tâches gérables pour gagner en confiance et acquérir de l'expérience. Au fur et à mesure que vous vous sentirez plus à l'aise, vous pourrez vous attaquer à des tâches et à des défis plus complexes.
+4. **Entrez en contact avec la communauté open source** : Rejoignez les forums en ligne, les plateformes de discussion et les groupes de médias sociaux liés aux projets qui vous intéressent. Dialoguez avec d'autres contributeurs, posez des questions et partagez vos connaissances.
+5. **Participez à des événements et à des conférences** : Participez à des événements, des conférences et des réunions sur l'open source pour apprendre des autres, nouer des contacts avec d'autres développeurs et vous tenir au courant des dernières tendances et des meilleures pratiques dans le monde de l'open source.
+6. **Partagez vos expériences** : Documentez votre parcours dans le domaine de l'open source en écrivant des articles de blog, en créant des tutoriels ou en faisant des présentations. Cela permettra non seulement aux autres d'apprendre de vos expériences, mais aussi de vous positionner en tant que leader d'opinion au sein de la communauté open source.
+7. **Apprentissage continu** : L'open source est un domaine dynamique et en constante évolution. Restez au fait des derniers outils, techniques et meilleures pratiques en participant à des ateliers, en suivant des cours en ligne et en lisant des articles et des livres sur le développement open source. Nous avons inclus une section de ressources additionnelles pour plus d'informations.
+
+En conclusion, se lancer dans l'aventure de l'open source est une expérience gratifiante et enrichissante qui peut vous aider à développer de nouvelles compétences, à nouer des liens avec des personnes partageant les mêmes idées et à avoir un impact durable sur les projets sur lesquels vous travaillez. Avec les connaissances et les outils que vous avez acquis dans ce cours, vous êtes bien préparé à relever les défis passionnants et à saisir les opportunités qui vous attendent dans le monde de l'open source. Alors, allez-y et commencez à contribuer, la communauté open source attend impatiemment votre participation !

intro-oss/README.md

@@ -0,0 +1,73 @@
+# Glossaire
+
+### Branche (Branch)
+
+Une branche est une version distincte du code créée à des fins de développement. Les branches permettent aux contributeurs d'expérimenter des modifications sans affecter la base de code principale. Lorsque les modifications sont prêtes à être fusionnées dans la base de code principale, elles sont généralement soumises sous forme de demande de tirage.
+
+### Un problème (Bug)
+
+Un problème est un bogue qui doit être résolu dans le code. Les problèmes peuvent être créés par n'importe qui, et ils sont souvent utilisés pour suivre les bogues, les demandes de fonctionnalités et d'autres tâches qui doivent être effectuées.
+
+### Cloner
+
+Le clonage est le processus utilisé pour copier un référentiel Git existant dans un nouveau répertoire local. La commande `git clone` créera un nouveau répertoire local pour le référentiel, copiera tout le contenu du référentiel spécifié, créera les branches suivies à distance et extraira une branche initiale localement. Par défaut, Git clone créera une référence au référentiel distant appelé origin.
+
+### Contributeur
+
+Un contributeur est toute personne qui apporte des modifications, des ajouts ou des suggestions à un projet open source. Les contributeurs peuvent être des développeurs, des concepteurs, des rédacteurs, des testeurs ou toute autre personne qui aide à améliorer le projet.
+
+### Membre principal (Team member)
+
+Un membre principal est un contributeur qui s'est vu accorder des privilèges ou des responsabilités supplémentaires au sein d'un projet open source. Les membres principaux sont généralement des contributeurs de confiance qui ont démontré une compréhension approfondie du projet et ont apporté des contributions significatives à son développement.
+
+### Docs
+
+Il s'agit d'une abréviation du mot documentation, un morceau de texte qui fournit des informations sur la manière de contribuer aux projets OSS et sur les attentes des contributeurs. Markdown, un langage de codage basé sur du texte, est souvent utilisé pour créer ces formes de contenu. Vous voulez en voir un en action ? Consultez le [Guide de style dans notre dépôt Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)!
+
+### Forker (Fork)
+
+Un Fork est une copie d'un dépôt. Lorsque vous bifurquez un référentiel, vous créez une nouvelle copie de la base de code que vous pouvez modifier et expérimenter sans affecter la base de code d'origine.
+
+### Dépôt (Repo/Repository)
+
+Un dépôt (repository) est un emplacement central où le code est stocké et géré. En open source, les dépôts sont souvent hébergés sur des plateformes comme GitHub, GitLab ou Bitbucket. Chaque référentiel peut contenir un ou plusieurs projets, et les contributeurs peuvent soumettre des modifications au code en faisant des demandes de tirage.
+
+### Issue
+
+Une issue est un problème ou un bogue qui doit être résolu dans le code. Les issues peuvent être créées par n'importe qui et sont souvent utilisés pour suivre les bogues, les demandes de fonctionnalités et d'autres tâches qui doivent être effectuées.
+
+### Mainteneur (Maintainer)
+
+Un mainteneur est une personne ou un groupe de personnes responsable de la maintenance d'un projet open source spécifique. Les mainteneurs sont généralement chargés d'examiner et d'accepter ou de rejeter les contributions des autres contributeurs. Ils ont également le pouvoir de prendre des décisions finales sur l'orientation et la portée du projet.
+
+### Markdown
+
+Markdown est un langage de balisage léger couramment utilisé pour créer des documents texte formatés. Il est largement utilisé pour créer de la documentation et des fichiers README dans le développement de logiciels en raison de sa simplicité et de sa lisibilité.
+
+### Demande de fusion (Merge request)
+
+La demande de fusion est le processus qui consiste à combiner les changements d'une branche dans une autre. Lorsqu'une demande d'extraction est acceptée et fusionnée, les modifications apportées dans la demande d'extraction deviennent partie intégrante de la base de code principale.
+
+### Onboarding
+
+La documentation d'accueil aide les nouveaux membres de l'équipe ou les collaborateurs à se familiariser rapidement avec la structure, les objectifs et les processus d'un projet.
+
+### Projets OSS
+
+OSS signifie "Open Source Software" (logiciel open source). Il s'agit de projets logiciels où le code source est mis à la disposition du public, permettant à quiconque de consulter, d'utiliser et de modifier le logiciel.
+
+### Demande de tirage (Pull request)
+
+Une demande de tirage est une demande d'un contributeur à un mainteneur pour que les modifications apportées au code soient intégrées dans une base de code.
+
+### Assurance qualité
+
+L'assurance qualité dans les projets open source implique des tests, des examens et la garantie que le logiciel répond aux normes souhaitées. Les membres de la communauté contribuent souvent aux tests et signalent les problèmes pour améliorer la qualité du logiciel.
+
+### Notes de version (Release note)
+
+Les notes de version sont des documents qui détaillent les changements, les améliorations, les corrections de bogues et les nouvelles fonctionnalités de chaque version logicielle. Elles informent les utilisateurs et les parties prenantes sur ce à quoi s'attendre dans une nouvelle version du logiciel.
+
+### Guide de style
+
+Un guide de style est un ensemble de règles et de conventions qui définissent le formatage, le style d'écriture et les éléments visuels utilisés dans la documentation et d'autres contenus. Il permet de maintenir la cohérence et la clarté des documents, ce qui facilite leur lecture et leur compréhension.

intro-oss/SUMMARY.md

@@ -0,0 +1,51 @@
+# Introduction
+
+Bienvenue dans le cours "Initiation à l'Open Source" ! Ce cours complet vous guidera à travers le monde fascinant de l'open source et vous aidera à devenir un contributeur actif. À la fin de ce cours, vous devriez avoir une solide compréhension de la façon de trouver, de rejoindre et de contribuer à des projets open source, ainsi que de la façon de développer votre CV open source. Mais d'abord, plantons le décor en discutant des prérequis, des objectifs et des attentes pour ce cours.
+
+### Conditions préalables
+
+Avant de plonger dans le monde de l'open source, il est essentiel d'avoir une compréhension de base des concepts de programmation et une certaine expérience de travail avec le code. Bien que le cours fournisse des exemples et des démonstrations, vous tirerez le meilleur parti du matériel si vous avez des connaissances préalables.
+
+De plus, ce cours suppose que vous êtes familiarisé avec Git et GitHub. Git est un système de contrôle de version largement utilisé, et GitHub est une plate-forme populaire pour l'hébergement et la collaboration sur les référentiels Git. Si vous n'êtes pas déjà familiarisé avec Git et GitHub, nous vous recommandons de prendre le temps d'apprendre les bases avant de commencer ce cours.
+
+### Objectifs
+
+Tout au long de cette formation, nos principaux objectifs sont de vous aider à :
+
+1. **Comprendre l'open source et ses avantages** : nous explorerons le concept d'open source, son histoire et les nombreux avantages de contribuer à des projets open source.
+2. **Apprenez à trouver des projets open source** : la découverte de projets qui correspondent à vos centres d'intérêt et à vos compétences est cruciale pour une expérience open source enrichissante. Nous vous présenterons des outils et des techniques pour trouver des projets auxquels contribuer.
+3. **Maîtrisez les outils et les processus de contribution** : nous vous donnerons un aperçu des outils et processus essentiels nécessaires à une collaboration open source réussie, tels que le contrôle de version, la révision du code et les plates-formes de communication.
+4. **Acquérir une expérience pratique** : en suivant des exemples et des démonstrations, vous aurez l'occasion de mettre en pratique vos compétences et de gagner en confiance dans votre capacité à contribuer à des projets open source.
+5. **Développez votre CV open source** : mettre en valeur vos contributions open source est essentiel pour bâtir votre réputation dans la communauté et démontrer votre expertise à des employeurs ou clients potentiels. Nous discuterons des stratégies pour développer et maintenir votre CV open source.
+
+### Attentes
+
+Ce cours est conçu pour vous fournir une base solide dans la collaboration open source. Bien que nous couvrions un éventail de sujets et que nous fournissions des exemples, des démonstrations et des opportunités de pratique, il est essentiel d'avoir des attentes réalistes quant à ce que vous pouvez accomplir pendant le cours.
+
+1. **La pratique est cruciale** : l'apprentissage de l'open source n'est que le début ; Pour vraiment développer vos compétences et devenir un contributeur compétent, vous devrez vous entraîner régulièrement. Gardez à l'esprit que plus, vous contribuez à des projets open source, plus vous apprendrez et évoluerez en tant que développeur.
+2. **La patience est la clé** : maîtriser la collaboration open source demande du temps et des efforts. Ne vous découragez pas si vous rencontrez des difficultés en cours de route ; rappelez-vous que chaque contribution, aussi petite soit-elle, est précieuse et contribue à améliorer le projet.
+3. **Engagement avec la communauté** : l'open source est plus qu'un simple code. Il s'agit des personnes qui collaborent et contribuent aux projets. Interagissez avec la communauté en posant des questions, en partageant vos connaissances et en soutenant les autres. Établir des relations avec d'autres contributeurs améliorera votre expérience open source et vous aidera à grandir en tant que développeur.
+4. **Apprentissage continu** : l'open source est un domaine en évolution rapide, avec de nouveaux projets, outils et technologies qui émergent en permanence. Restez curieux et ouvert à l'apprentissage, et profitez de ressources telles que la documentation, les didacticiels et les forums communautaires pour approfondir vos connaissances et rester au courant des derniers développements.
+5. **Développer un état d'esprit de croissance** : Relevez les défis et les opportunités qui accompagnent la collaboration open source. Adoptez un état d'esprit de croissance axé sur l'apprentissage, l'amélioration et la résilience. En considérant les obstacles comme des opportunités de croissance, vous serez mieux équipé pour naviguer dans le monde complexe de l'open source et réussir vos contributions.
+
+### Structure du cours
+
+Ce cours est divisé en plusieurs chapitres, chacun conçu pour couvrir un aspect spécifique de la collaboration open source :
+
+1. **Introduction :** Nous commencerons par préparer le terrain pour votre parcours open source, en discutant des prérequis, des objectifs et des attentes.
+2. **Qu'est-ce que l'open source ? :** Dans ce chapitre, nous explorerons la définition de l'open source et son histoire, vous fournissant une base solide pour comprendre le contexte de la collaboration open source.
+3. **Pourquoi l'Open Source ? :** Nous aborderons les avantages de l'Open Source, notamment l'accès aux connaissances, la communauté et le développement des compétences.
+4. **Outils pour réussir :** Ce chapitre vous présentera les outils essentiels pour une collaboration open source réussie, notamment GitHub, Git, CodeSee, VS Code et Discord.
+5. **Comment contribuer à l'Open Source :** Dans ce chapitre, nous discuterons du processus de recherche de projets sur lesquels travailler, de soumission de contributions, d'intégration dans un nouveau projet et de ce à quoi s'attendre après la soumission de votre contribution.
+6. **La sauce secrète :** Ce chapitre vous dévoilera les stratégies et les techniques pour démarrer, gagner du terrain dans vos contributions et développer votre CV open source.
+7. **Conclusion :** Nous conclurons le cours avec des points clés et discuterons des prochaines étapes de votre parcours open source.
+
+Tout au long de ce cours, nous fournirons des exemples et des démonstrations pour aider à illustrer les concepts clés et fournir des opportunités pratiques de pratique. Dans la mesure du possible, nous présenterons des projets et des outils open source réels, tels que [OpenSauced](https://opensauced.pizza/), [Tublian](https://tublian.com/) pour montrer comment appliquer les compétences que vous avez acquises.
+
+Veuillez noter que bien que ces exemples et démos soient conçus pour vous guider et vous inspirer, votre propre parcours open source peut différer en fonction de vos intérêts, de vos compétences et des projets choisis.
+
+Utilisez les exemples et les démonstrations comme point de départ, mais n'ayez pas peur d'explorer d'autres projets, outils et ressources à mesure que vous continuez à apprendre et à grandir.
+
+### Commençons
+
+Maintenant que nous avons planté le décor, il est temps de vous lancer dans votre aventure open source. Dans le chapitre suivant, nous plongerons dans la définition de l'open source et explorerons son histoire, jetant les bases d'une compréhension plus approfondie de la collaboration open source. D'accord, allons-y !