Contenu | Rechercher | Menus

Annonce

Ubuntu 16.04 LTS
Commandez vos DVD et clés USB Ubuntu-fr !

Pour en savoir un peu plus sur l'équipe du forum.

Appel à contributeurs pour la doc.

Si vous avez des soucis pour rester connecté, déconnectez-vous puis reconnectez-vous depuis ce lien en cochant la case
Me connecter automatiquement lors de mes prochaines visites.

#1 Le 11/08/2017, à 15:53

Aldian

Chantier de simplification des règles de rédaction de la doc

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!

Hors ligne

#2 Le 15/08/2017, à 23:47

Roschan

Re : 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