Qu’est-ce que GitHub ?

GitHub est une plateforme collaborative permettant de gérer et de réviser du code ou du texte à plusieurs.
Un projet est hébergé sous forme de dépôt, que son créateur peut modifier tout en recevant des contributions extérieures.

GitHub offre également la possibilité de générer des pages web à partir des dépôts via GitHub Pages.
C’est précisément cette fonctionnalité qui est utilisée pour ce site. Tout son contenu est libre et accessible sur le dépôt de l’Infinifab, offrant à chacun la possibilité de contribuer à son élaboration.


Comment participer ?

⚠️ Pour contribuer, il est impératif de posséder un compte GitHub.
Notez que l’interface et les instructions de GitHub sont en anglais.

🔧 Proposer une modification de contenu

Chaque page du site contient un lien vers GitHub en bas de page, vous permettant de proposer des modifications.

1. Accéder au texte à modifier

En bas de chaque page, cliquez sur le lien GitHub correspondant.

Une fois sur GitHub, vous verrez le texte de la page. Cliquez sur “Edit this file” pour le modifier.

2. Créer un “fork” du dépôt

Si c’est votre première modification, GitHub vous demandera de créer une copie du dépôt : cliquez sur “Fork this repository”.

3. Modifier le texte et soumettre les changements

Une fois votre modification effectuée, cliquez sur le bouton vert “Commit changes…”.

Avant de soumettre votre proposition, ajoutez un petit commentaire expliquant votre modification, puis cliquez sur “Propose changes”.

Enfin, pour envoyer vos modifications, cliquez sur “Create pull request”.
Je pourrai alors examiner votre proposition et l’intégrer au site.

Tous les retours sont les bienvenus ! Un grand merci à ceux qui prennent le temps de contribuer. 😊


💬 Juste une remarque ?

GitHub propose une section Issues, qui fonctionne comme un forum. Vous pouvez y ouvrir une discussion sur un sujet concernant le fablab ou le contenu du site.

1. Accéder aux discussions

Sur le dépôt GitHub d’Infinifab, cliquez sur “Issues”.

2. Participer ou créer un sujet

Vous pouvez répondre à une discussion existante ou en créer une nouvelle en cliquant sur “New issue”.


📝 La syntaxe Kramdown

Les pages de ce site sont écrites en Kramdown, un langage de mise en page simple qui allège le code.
Si vous ne connaissez pas Kramdown, pas d’inquiétude ! Vous trouverez de nombreuses ressources en ligne pour vous aider.

Dans tous les cas, proposez vos modifications et je m’occuperai d’éventuelles corrections.

🔗 Guide rapide sur Kramdown (en anglais)