Contribuer à la documentation

Traduction anglaise: Contribute to the documentation

Introduction

La documentation est un pilier essentiel de tout projet open source. En contribuant vous permettez de rendre la plateforme plus facile d'accès. Merci à vous 👍.

Documenter ne nécessite aucune compétence technique particulière.

Communauté autour de la documentation : communecter.org/#codocwiki

Lire la documentation

Selon votre profil il existe 3 portes d'entrée :

Contribuer

Créer un compte github (obligatoire)

Si vous souhaitez éditer la documentation il faut vous inscrire sur github. C'est rapide et gratuit :smile:.

  1. Cliquez ici et remplissez le petit formulaire
  2. À la 2ème étape choisissez "Unlimited public repositories for free"
  3. Sautez la 3ème étape en cliquant sur "skip this step" à côté du bouton "Submit"
  4. Ouvrez vos mails pour valider votre adresse

Modifier une page

  1. Cliquez sur le bouton "Éditer"
  2. Cliquez sur "Save Page"

Votre modification sera affichée sur wiki.communecter.org après de la mise à jour automatique qui a lieu chaque nuit.

Pour mettre à jour manuellement wiki.communecter.org il faut lancer le script sur cette page (le chargement prendra une dizaine de secondes).

Créer une page

  1. Accédez au wiki via Github
  2. Cliquer sur "New Page" à côté du bouton "Edit".

    Le nom des pages du wiki ne doit pas contenir de caractères spéciaux comme "?" ou "(" ou ":" par exemple.

Markdown ?

Markdown est le langage utilisé par github (et Communecter) pour mettre en forme du texte. Exemples : **Texte en gras** _Texte en italique_.

Il existe de nombreux guides pour débuter. En voici un : pense-bête markedown.

Si son usage vous fait peur, il existe des éditeurs visuels comme StackEdit.

Modifier le sommaire

Le sommaire dans la barre latérale de droite doit contenir des pages du wiki sous forme de [liens internes](liens-internes.html). Il ne peut pas contenir de liens externes.

Titres

Le # titre de 1er niveau doit systématiquement apparaître en début de page et indique le nom de la page. Les ## et ### peuvent être utilisés comme on le souhaite après dans la page.

Liens internes

Dans l'ensemble du wiki, les liens internes doivent toujours être notés [Nom de la page](nom-de-la-page.html) et jamais [Nom de la page](https://github.com/pixelhumain/wiki/wiki/Nom-de-la-page).

Images

Les images doivent être partagées via le cloud de communecter.

Tutoriel vidéo

Fonctionnement technique

Un script automatique convertit le wiki de Github vers un format interprété par Gitbook. En savoir + : Gitbook - configuration.

Ressources

Nous sommes disponibles à tout moment sur le chat.