Aller au contenu

Proposer un article#

icône article

La rédaction d'articles est ouverte à toute personne souhaitant partager une expérience, l'histoire de la conception d'une carte, une méthodologie, un outil, un tutoriel, un billet d'humeur ou autre tant qu'il ne s'agit pas d'une publicité ou d'un communiqué ou contenu assimilable.

Gardez en tête que le travail de l'équipe est bénévole. A ce titre, plus votre contenu est conforme à nos prérequis et aux guides de contribution, moins il ne demande de travail de notre part. Ce que vous ne faites pas, nous devrons le faire.

Bref, appliquons le principe du fair-use1 au bénévolat 🤗 !

Rédiger#

icône globe tricot

Allez, cette fois, c'est parti ! L'angoisse de la feuille blanche n'a qu'à bien se tenir, vous êtes prêt/e à coucher votre prose !

Comme indiqué dans les prérequis, qu'importe le flacon, tant qu'on a l'ivresse de la rédaction en Markdown : du simple éditeur de texte (oui, même le bloc-notes de Windows !) à l'éditeur lourd (à ce propos voir le dossier de Next INpact), faites votre choix !
Mais sachez que nous mettons un éditeur collaboratif (Hedgedoc) à disposition des contributeur/ices :

Utiliser le PAD

Sinon, cela tient en quelques étapes :

  1. Créer un fichier Markdown (extension .md ou markdown)
  2. Copier/coller le modèle d'article dans votre fichier :
  3. Remplir les parties !
  4. Faire relire

🦮 Lire et s'appuyer sur les guides de rédaction :

Problème ? Souci ? Angoisse ? Simple question ?

Contacter l'équipe pour échanger


Soumettre#

logo GitHub

Une fois le contenu prêt, il ne reste plus qu'à pousser le contenu sur le dépôt GitHub. La procédure est différente selon si vous des droits en écriture ou non sur le dépôt GitHub. Ces droits sont généralement réservés aux contributeur/ices régulier/ères et aux membres de l'équipe.

Je n'ai pas accès en écriture#

Si vous n'avez pas l'habitude des plateformes basées sur Git, sachez qu'il va vous falloir :

  1. Créer un dépôt dérivé (fork) sur votre compte GitHub à partir du dépôt GitHub original de Geotribu :

    Forker le dépôt GitHub

    GitHub fork repository

    Déjà forké auparavant ?

    A noter que si vous aviez déjà forké notre dépôt auparavant, il vous suffit de mettre à jour le dépôt dérivé sur votre compte via le bouton Fetch Upstream :
    Github update fork

  2. Ajouter votre article dans votre dépôt dérivé :

    • soit via Git (ou un outil l'utilisant) si vous ça vous parle,
    • soit directement depuis l'interface web de GitHub en cliquant sur Add file :

    GitHub add file

  3. Nommer le fichier selon la convention de nommage content/articles/YYYY/YYYY-MM-DD_XXXXXX où :

    • YYYY est l'année de publication
    • MM le mois de publication prévisionelle
    • DD le jour de publication prévisionnelle
    • XXXXXX le nom de l'article sans les caractères spéciaux ou les mots superflus (prépositions...)

    Tip

    Penser à s'inspirer des articles déjà publiés 😉 !
    La date de publication pourra être amenée à changer selon les autres contenus planifiés.

  4. Créer la Pull Request2 directement depuis votre dépôt dérivé via le bouton Contribute :

    GitHub submit pull request from fork

  5. Adapter la description de la Pull Request en indiquant rapidement le sujet et la motivation de l'article :

    GitHub Pull Request form

J'ai accès en écriture#

  1. Créer une branche en respectant la convention de nommage suivante article/XXXXXXXXXXXX est nom de l'article en minuscules et sans caractère spécial

    Github - New branch

  2. Créer un fichier selon la convention de nommage content/articles/YYYY/YYYY-MM-DD_XXXXXX où :

    • YYYY est l'année de publication
    • MM le mois de publication prévisionelle
    • DD le jour de publication prévisionnelle
    • XXXXXX le nom de l'article sans les caractères spéciaux ou les mots superflus (prépositions...)

    Tip

    Penser à s'inspirer des articles déjà publiés 😉 !
    La date de publication pourra être amenée à changer selon les autres contenus planifiés.

    Github - Pull Request button

  3. Créer la Pull Request2 en choisissant la branche de l'article comme source (head) et la branche principale (master ou main) comme destination (ref).

  4. Adapter la description de la Pull Request en indiquant rapidement le sujet et la motivation de l'article

    GitHub Pull Request form

  5. Demander la relecture sur Slack, dans le canal Articles


Publication et diffusion#

icône porte-voix

Une fois la Pull Request2 validée par un membre de l'équipe, une date de publication est décidée en tenant compte du planning de publication.

Une fois la branche de l'article fusionnée (merged) dans la branche principale, votre contenu est publié et référencé automatiquement.

En ce qui concerne la diffusion, cela reste à la discrétion de chacun/e, sachant que nous utiliserons le compte Twitter de Geotribu pour relayer la publication.


  1. analogie avec un cadre légal qui repose sur un usage raisonnable des oeuvres et ressources. Voir la fiche Wikipedia

  2. étape où un contributeur propose d'intégrer ses modifications dans le socle principal du projet. Voir la documentation de GitHub


Dernière mise à jour: 6 octobre 2021
Créé: 28 septembre 2021
Contributions à cette page : Julien Moura (99.39%), Florian Boret (0.61%)

Ce contenu est sous licence Creative Commons BY-NC-SA 4.0 International


Commentaires

Une version minimale de la syntaxe markdown est acceptée pour la mise en forme des commentaires.
Propulsé par Isso.
Retour en haut de la page