#1 Le 11/08/2017, à 14:53
- Aldian
[Terminé] Chantier de simplification des règles de rédaction de la doc
Edit: Chantier terminé, la nouvelle page wiki/participer_wiki est désormais à finalisée, merci à tous!
Bonjour à tous
Pour ceux qui suivent un peu ce qui se passe au niveau de la documentation, nous sommes au cœur d'un processus de réflexion et de modernisation qui a été lancé il y a quelques semaines par le topic Appel à contributeurs pour la doc (s'y référer pour plus de détails). Parmi les nombreux chantiers qui ont été décidés, il y en a un qui est assez fondamental puisqu'il nous concerne tous au quotidien, ainsi que tous ceux qui veulent nous rejoindre dans notre travail: celui de la simplification des règles de rédaction. Je vais citer le récapitulatif des chantiers en cours:
A l'heure actuelle le nombre de pages à lire avant de pouvoir participer au wiki est de nature dissuasif:
L'idée est de proposer un tutoriel simplifié au strict minimum permettant de comprendre comment rédiger une page harmonisée avec les règles du wiki et de renvoyer vers des pages qui permettent de creuser chaque thématique lorsque les gens se posent des questions. Ce tutoriel devra au maximum éviter de lister des possibilités et de distinguer des cas de figure: il faut être synthétique et aller droit au but.
Dans le but de lancer ce chantier, nous, admins de la doc, aimerions que chacun donne son avis: est-ce qu'il a déjà lu les pages concernées, si oui qu'est-ce qu'il en a pensé, si non qu'est-ce qui l'en a dissuadé (vous avez le droit de dire que c'est par flemme), et plus globalement quelles sont les suggestions et remarques que vous avez à formuler sur la manière dont les règles du wiki sont présentées aux nouveaux arrivants. Vous noterez qu'on ne vous demande pas ici de critiquer ces règles (il est possible de nous contacter via notre ML pour cela), mais uniquement de réagir sur la manière dont elles sont présentées.
Alors comme cet appel à réagir a été posté sur plusieurs supports, vous êtes invités à participer sur le framapad créé pour l'occasion, ce qui permettra de simplifier l'effort de récapitulation des arguments de tout le monde. Vous pouvez quand même répondre à ce post si vous ressentez le besoin de développer plus longuement votre point de vue.
Merci d'avance!
Dernière modification par Aldian (Le 03/10/2017, à 09:17)
Hors ligne
#2 Le 15/08/2017, à 22:47
- Roschan
Re : [Terminé] Chantier de simplification des règles de rédaction de la doc
Faut être moins verbeux, c'est pas parce que les phrases sont longues et les paragraphes volumineux que ça rend la doc davantage sérieuse
Hors ligne
#3 Le 15/09/2017, à 09:47
- Aldian
Re : [Terminé] Chantier de simplification des règles de rédaction de la doc
Pour information, ce chantier est désormais terminé, et la nouvelle page wiki/participer_wiki est en ligne depuis quelques jours. Nous espérons qu'il sera plus simple pour tout le monde de comprendre comment contribuer en la lisant et que la lecture sera plus simple.
Essentiellement on dit la même chose que ce qu'on disait avant, mais on a fait un gros effort pour simplifier le plan de la page, éviter les énumérations pénibles à lire, faire des phrases courtes et simples, et plus globalement dire les choses plus simplement et avec moins de mots. Au final la page est un tiers plus légère que la précédente, et espérons-le, beaucoup plus digeste! 
Dernière modification par Aldian (Le 02/10/2017, à 16:05)
Hors ligne
#4 Le 15/09/2017, à 10:32
- kholo
Re : [Terminé] Chantier de simplification des règles de rédaction de la doc
salut Aldian,
pas d'accès à cette page...
participer_wiki
Piste:
Cette page n'existe pas encoreVous avez suivi un lien vers une page qui n'existe pas encore. Si vos permissions sont suffisantes, vous pouvez la créer en cliquant sur « Créer cette page ».
Hors ligne
#5 Le 15/09/2017, à 11:01
- erresse
Re : [Terminé] Chantier de simplification des règles de rédaction de la doc
+1, même chose que kholo, la page n'existe pas...
Plus de 50 ans d'informatique, ça en fait des lignes de commandes en console, mais on n'avait pas le choix...
Excellente raison pour, aujourd'hui qu'on le peut, utiliser au maximum les INTERFACES GRAPHIQUES !
Important : Une fois le problème solutionné, pensez à clore votre sujet en ajoutant [Résolu] devant le titre du 1er message, et un bref récapitulatif de la solution à la fin de celui-ci. Merci.
Hors ligne
#6 Le 19/09/2017, à 18:15
- fabux
Re : [Terminé] Chantier de simplification des règles de rédaction de la doc
Salut,
en fait elle est là
May linux be with you
Comment poster un message.
Je me présente dans la doc
Hors ligne
#7 Le 02/10/2017, à 16:06
- Aldian
Re : [Terminé] Chantier de simplification des règles de rédaction de la doc
Ah oui, autant pour moi, merci Fabux d'avoir rectifié
+Ajout d'une note sur le premier topic pour qu'il soit tout de suite évident que le chantier est fini.
Dernière modification par Aldian (Le 03/10/2017, à 09:16)
Hors ligne