Licence CC BY

Le guide du contributeur

Eh vous ! Vous voulez contribuer à Zeste de Savoir ? Mais peut-être ignorez-vous ce qu’est ce site précisément ? Pour votre gouverne, sachez que Zeste de Savoir, communément appelé ZdS, est une plate-forme libre, gratuite et communautaire de partage de connaissances, sur tout sujet, de tout niveau.

« Libre », cela signifie que tout le monde est autorisé à utiliser le code source du site à sa guise. « Gratuit », c’est simplement « pas payant » ; en particulier, vous ne croiserez jamais de publicité. Et « communautaire », parce que tout le monde peut participer : ici, pas de hiérarchie, ni de professeurs ou d’experts ayant le monopole sur le contenu ou le développement du site. C’est pourquoi Zeste de Savoir repose entièrement sur les contributions bénévoles de ses membres, quels qu’ils soient.

Donc si vous aussi vous croyez au partage libre des connaissances et souhaitez vous impliquer dans le projet, consultez ce guide du contributeur !

Ce tutoriel n’aborde pour le moment que comment contribuer au contenu en lui-même. À terme, il devrait aussi expliquer comment participer au développement de la plate-forme ou encore comment et pourquoi rejoindre l’association.

Sachez par ailleurs que la lecture de l’ensemble des chapitres de ce guide n’est pas forcément nécessaire. Vous pouvez ne lire que les chapitres qui vous sont d’intérêt.

Sachez également qu’il est possible de suivre les mises à jour de ce guide (ou de tout autre contenu) voire d’être notifié par courriel (celui utilisé pour l’inscription sur le site) via les liens figurant dans le menu de gauche. :)

Liens « Suivre ce contenu » et « Être notifié par courriel »
Liens « Suivre ce contenu » et « Être notifié par courriel » dans le menu de gauche.

Contribuer au contenu

  1. Généralités

    1. Un mot sur le zMarkdown

    2. Types de contenu

    3. Cycle de vie des contenus

    4. Écrire seul ou à plusieurs

    5. Participer à des contenus

    6. Rédiger en hors-ligne avec Zest Writer

    7. Les cas particuliers

  2. Amorce de la rédaction

    1. Choix du sujet

    2. Créer un contenu 1/2

    3. Créer un contenu 2/2

    4. Les galeries d'images

    5. Importer un contenu

  3. La rédaction

    1. Définition du niveau technique du contenu

    2. Structure et organisation

    3. Importance de la pédagogie

    4. La mise en forme

    5. Les références

    6. Quelques conseils de rédaction

  4. Les phases de correction et de validation

    1. Demander des retours

    2. Bien utiliser la bêta !

    3. Bien utiliser la validation !

    4. Point particulier : la validation partielle

    5. Critères de validation

  5. Aider à la correction des contenus

    1. Signaler une erreur d'orthographe

    2. Proposer une amélioration à un contenu

    3. Proposer son aide à un auteur

    4. Faire des remarques sur un contenu en bêta

  6. Participer aux forums

    1. Aider sur les forums

    2. Suggérer des idées

    3. Organiser des projets

Rejoindre l'association

  1. Présentation de l'association
  2. Comment la rejoindre ?

Annexes

  1. Système de classement de la Bibliothèque sur Zeste de Savoir

    1. Classification de la Bibliothèque sur Zeste de Savoir

    2. Choix des catégories et des tags

    3. Gestion des catégories et des tags

  2. J'ai du mal à trouver une idée et un plan

    1. Techniques de brainstorming

    2. Préparer son contenu : se poser les bonnes questions

    3. Formaliser le plan et le premier jet



Voilà, c’est la fin de ce guide ! À travers celui-ci, nous avons vu comment contribuer au contenu de ZdS.

N’hésitez pas à émettre des remarques en commentaire. Le contenu et la pertinence du guide du contributeur est voué à évoluer et évoluera en fonction des remarques émises lors de la validation et des retours des membres (toi, là, nous t’avons vu ! :) ).

Pour autant, ce n’est pas l’unique façon de participer : il est également possible de s’impliquer dans le développement de la plate-forme voire de rejoindre l’équipe technique (qui est constituée de certains membres du site) dont le but est d’une part de s’assurer que le site reste toujours disponible en ligne, et d’autre part de corriger les bogues rencontrés sur le site ainsi que d’ajouter de nouvelles fonctionnalités. Des administrateurs systèmes jusqu’aux designers, en passant par les développeurs back-end et intégrateurs front-end, ils s’occupent aussi de la maintenance du dépôt officiel du projet.

Nous espérons que ce présent texte vous aura séduit et qu’il vous épaulera dans votre participation. En tout cas, nous serons ravis de vous croiser sur ZdS de quelle que manière que ce soit. :)

À bientôt !

Remerciements

Merci à Anto59290, Gabbro et Holosmos pour leurs remarques pertinentes. Un tout grand merci à Taurre pour le temps qu’il a alloué à la validation de ce guide !

25 commentaires

Enfin ! Merci à toutes les personnes qui ont contribué à la rédaction de ce guide !

Peut-être faudrait-il préciser dès l'intro que ce guide peut (devrait ?) être lu en sélectionnant les bouts qui nous intéressent et non comme un tout ; parce qu'en l'état y'a un gros effet « Voici les 6 parties que tu dois apprendre pour pouvoir contribuer à ZdS ».

Édit : c'est fait, merci Arius !

Ah ce guide tant attendu, fait enfin son apparition. Merci à toute la team pour ce tutoriel guide et j'attends la suite avec impatience. Fini les excuses pour ne pas participer :(

Peut-être faudrait-il préciser dès l'intro que ce guide peut (devrait ?) être lu en sélectionnant les bouts qui >nous intéressent et non comme un tout ; parce qu'en l'état y'a un gros effet « Voici les 6 parties que tu dois >apprendre pour pouvoir contribuer à ZdS ».

Je lève mon pousse :D

+0 -0

Ok, ce sera ajouté.

N'hésitez pas à émettre des remarques et questions, voire des conseils (pourquoi pas) portant sur la rédaction, la correction d'une manière générale. C'est écrit noir sur blanc dans la conclusion du guide mais j'insiste dessus. :)

+0 -0

Comme tu peux le voir en bas de page, c’est parce que tu es en v21-carcajou que tu n’as plus de notification persistante.

Le développement de zds est en pleine reprise d’activité et des grosses avancées sont en cours, notamment grâce à la très grosse activité d’Anto59290, au lead de Jiyong et aux avancées techniques apportées par pierre-24. Si tu aimes le code, notre github est là pour te mettre des étoiles aux yeux.

Comme tu peux le voir en bas de page, c’est parce que tu es en v21-carcajou que tu n’as plus de notification persistante.

Le développement de zds est en pleine reprise d’activité et des grosses avancées sont en cours, notamment grâce à la très grosse activité d’Anto59290, au lead de Jiyong et aux avancées techniques apportées par pierre-24. Si tu aimes le code, notre github est là pour te mettre des étoiles aux yeux.

artragis

Je passe de temps en temps dessus. :magicien:

+0 -0

Dans la partie concernant l’aide que l’on peut apporter aux auteurs (en particulier via la page de demande de contribution), il serait agréable d’avoir plus d’information sur comment accepter cette contribution pour l’auteur.

Autrement dit, est-ce qu’il faut nécessairement ajouter l’illustrateur ou le correcteur comme auteur, ou pas, et comment.

+0 -0

La personne qui demande doit contacter l’auteur par MP qui peut ensuite l’intégrer avec le processus standard de rédaction, il n’y a pas d’option particulière pour ajouter des correcteurs par exemple.

Du coup, tu peux soit ajouter les personnes qui se proposent comme co-auteurs, soit ne pas le faire (ça peut marcher pour les illustrateurs). ;)

Pour information, j’ai profité de la mise à jour récente du guide (pour des corrections mineures) pour m’y remettre et préparer la prochaine mise à jour (majeure, cette fois) du guide qui comprendra deux nouvelles parties :

  • La première reviendra sur les problèmes fréquemment rencontrés par les membres, notamment 1) la préparation du contenu (difficulté à trouver et formaliser une idée de contenu : on va aborder différentes techniques de brainstorming, préparation du plan, structure du contenu jusqu’au premier jet) et 2) les difficultés liées à l’absence ou l’insuffisance de retours de la bêta (qui est parfois très problématique, savoir stimuler les retours est primordial). D’autres points seront probablement ajoutés dans cette partie.
  • La deuxième partie, bien plus courte, portera sur l’association.

A mon avis, ça sera envoyé en validation début 2018. :)

Joyeuses fêtes de fin d’année <3

+5 -0

Lut,

Il serait peut-être pratique que ce guide soit accessible directement et bien visiblement depuis la page d’accueil. Je me souviens avoir ramé pour le trouver.

Bien entendu, en recherchant "guide" on tombe dessus, mais tutoriel, article, billet, rédaction, participer, contribuer ou autres mots clefs n’y renvoient pas.

Aurais-je du écrire ceci dans le forum "Bugs et Suggestions" ? J’ai hésité.

Hello,

En effet, ce serait bien plus pratique. Mais c’est une demande à transmettre aux devs.

Il faudrait aussi le mettre à jour afin qu’il reflète les dernières modifications de l’outil de rédaction du site. Faudrait que je m’y remette et finisse la mise à jour des sections concernées mais je suis pris avec des contenus plus urgents.

+3 -0

Je t’invite à lire les chapitres 1 à 6 du guide. Tu auras la réponse à tes premières questions.

N’hésite pas à revenir vers nous, par MP ou ici même, si tu as d’autres questions. :)

+1 -0
Connectez-vous pour pouvoir poster un message.
Connexion

Pas encore membre ?

Créez un compte en une minute pour profiter pleinement de toutes les fonctionnalités de Zeste de Savoir. Ici, tout est gratuit et sans publicité.
Créer un compte