Contribuer

Retrouvez ici toutes les informations vous permettant de nous aider à modifier ce wiki

Bienvenue ! Ce guide vous accompagnera pas à pas dans la contribution au wiki du projet Blocaria sur GitHub.

📋 Pré-requis

• Créez un compte GitHub : Inscription GitHub.

• Installez Git sur votre ordinateur : Télécharger Git.

• Choisissez un éditeur simple et convivial comme Visual Studio Code.

⚙️ Installer et configurer Git

Après l'installation, ouvrez votre terminal et configurez votre nom et email (ceux utilisés pour GitHub) :

git config --global user.name "Votre Nom"
git config --global user.email "[e-mail]"

🚀 Faire une contribution

1. Forker le Repository

• Rendez-vous sur wiki-blocaria

• Cliquez sur le bouton Fork en haut à droite pour créer une copie du repository sur votre compte.

2. Cloner votre Fork sur votre ordinateur

Copiez le lien de votre fork puis dans votre terminal :

git clone https://github.com/VOTRE-NOM-UTILISATEUR/wiki-blocaria.git
cd wiki-blocaria

3. Créer une nouvelle branche

Créer une branche par sujet traité pour bien organiser vos contributions :

git checkout -b nom-de-votre-branche

Exemple : git checkout -b ajout-guide-capture

4. Modifier le Wiki

• Utilisez Visual Studio Code pour éditer les fichiers markdown (.md).

• Vous pouvez également créer de nouveaux fichiers, par exemple comment-creer-ma-box.md.

Exemple de structure markdown simple :

# Titre principal

## Sous-titre

Votre contenu ici...

- Liste à puces
- Second point

[Un lien utile](http://example.com)

5. Ajouter vos modifications à Git

Dans votre terminal, ajoutez et validez vos changements :

git add .
git commit -m "Ajout du guide sur les métiers"

6. Envoyer votre contribution

Envoyez vos modifications sur GitHub :

git push origin nom-de-votre-branche

7. Ouvrir une Pull Request (PR)

• Retournez sur votre fork du projet GitHub.

• Cliquez sur Compare & pull request.

• Décrivez votre contribution clairement puis validez en cliquant sur Create pull request.

💡 Bonnes pratiques et conseils

• Restez clair et concis dans vos explications.

• Vérifiez l'orthographe et la grammaire.

• Structurez bien vos pages markdown.

• Utilisez les prévisualisations markdown de Visual Studio Code (Ctrl + Shift + V) avant de soumettre.

🛠️ En cas de problème

N'hésitez pas à créer une issue sur GitHub pour demander de l'aide ou poser une question.

Merci pour votre contribution ! ✨