[fedora-fr-doc] Manuel du débutant

José Fournier jaaf64 at zoraldia.com
Mar 10 Avr 07:07:14 CEST 2018


Bonjour à tous,

@Nicolas

Dis-moi, Nicolas, concernant le parcours guidé, quand tu parlais d'aérer, hier soir, avais-tu quelque chose en vue
particulièrement ou est-ce plutôt général.
Et puis, tu dis bien « aérer », pas « alléger », je comprends donc la chose comme une sorte de décompactage du texte.
Merci de me préciser ce que tu as voulu dire et si ça vise des endroits particuliers.



Le 08/04/2018 à 16:24, Édouard Duliège a écrit :
> Hello,
>
> Pas le temps de lire en détails ce que tu as fais, mais la structure est claire et l'introduction excellente. Les
> schémas m'ont l'air très bien aussi. Un grand merci pour ce travail très bien réalisé qui a du prendre un temps certain !
>
> Urbanely yours,
>
> Édouard
>
> --
> Édouard Duliège
> edouard.duliege at gmail.com <mailto:edouard.duliege at gmail.com>
>
> Le 3 avril 2018 à 14:48, José Fournier <jaaf64 at zoraldia.com <mailto:jaaf64 at zoraldia.com>> a écrit :
>
>     Le 29/03/2018 à 09:54, José Fournier a écrit :
>     > Le 29/03/2018 à 09:34, Charles-Antoine Couret a écrit :
>     >> Le 29/03/2018 à 08:47, José Fournier a écrit :
>     >>> La question que pose Vivien est de première importance. J'avoue en
>     >>> relisant  la page sur les fondations et les missions de Fedora, ne pas
>     >>> savoir franchement y répondre, mais que je n'y vois pas non plus une
>     >>> réponse négative.
>     >>>
>     >>> https://docs.fedoraproject.org/fedora-project/project/fedora-overview.html
>     <https://docs.fedoraproject.org/fedora-project/project/fedora-overview.html>
>     >> Bien entendu que rien n'empêche que Fedora soit utilisable pour le débutant. Et honnêtement à peu de choses
>     près, un
>     >> débutant chez Fedora ne devrait pas être plus perdu que chez Ubuntu. Les interfaces d'aujourd'hui sont bien plus
>     >> clairs que par le passé.
>     >>
>     >> Mais Fedora, contrairement à Ubuntu ou Mageia, ne cible pas les débutants dans ses objectifs. Donc globalement
>     la doc
>     >> est moins axée vers ce but, la communauté aussi, peut être qu'il y aura certains choix de développement qui ne
>     seront
>     >> pas adaptés aux débutants pour favoriser d'autres axes mentionnés dans le projet.
>     >>
>     >> Il ne faut pas perdre de vue cela. Mais je pense que Fedora reste une distribution simple et qu'un débutant
>     curieux a
>     >> tout à fait sa place et qu'on doit l'aider dans la mesure du possible.
>     > Alors sur ce point nous sommes d'accord.
>     >>>>> Cela dit, si cela aide grandement à éclaircir et simplifier certains
>     >>>>> pans de la documentation, pourquoi pas.
>     >>>> Je pense qu'il est souhaitable de simplifier le Wiki là où c'est
>     >>>> nécessaire ou pertinent. Si José a des idées concrètes, pourquoi pas.
>     >>>> Après l'idée d'une sorte de livre, en tant que tel, je n'y suis pas
>     >>>> favorable. C'est un wiki, par essence on ne contrôle pas vraiment le
>     >>>> flux de lecture et l'outil n'est pas vraiment adapté. On peut
>     >>>> difficilement faire mieux qu'un article sommaire pointant vers des
>     >>>> articles indépendants ou paraphrasant le gros du contenu. J'ai peur
>     >>>> qu'on se retrouve avec trop de contenus dupliqués à maintenir (du genre
>     >>>> expliquer 3 fois la procédure d'installation).
>     >>> Je pense ne pas m'être fait comprendre. Ma démarche, avec la création
>     >>> d’un parcours guidé,  est de faciliter l'approche d'un univers nouveau
>     >>> au débutant, mais aussi d'éviter la duplication. Rien n'empêche de créer
>     >>> des pages indépendantes et de les inclure dans un parcours guidé — la «
>     >>> transclusion » est à la base même d'un wiki ; ne  pas écrire deux fois
>     >>> la même chose me semble être une contrainte à respecter. Mais pour être
>     >>> honnête cela réclamera peut-être l'intervention d'un administrateur pour
>     >>> configurer certains aspects du wiki.
>     >> Je ne vois pas en quoi un admin est nécessaire.
>     >> Si je peux t'aider, car j'ai les droits, n'hésite pas.
>     > En fait je n'en suis pas sûr moi non plus. Je te dirai si le besoin d'intervenir se fait sentir.
>     >> Je reste dubitatif sur la possibilité de faire ce que tu veux sans trop répéter le contenu. Mais si tu en es
>     >> convaincu, je suis intéressé de voir le résultat. ;)
>     >>> Cette page du wiki de Gentoo montre que l'approche de pages enchaînées
>     >>> est praticable.
>     >>>
>     >>> https://wiki.gentoo.org/wiki/Handbook:AMD64/Working/Portage
>     <https://wiki.gentoo.org/wiki/Handbook:AMD64/Working/Portage>
>     >>>
>     >>> Le but de Gentoo est justement de produire un handbook spécifique à
>     >>> chacune des architectures sans écrire deux fois les parties communes et
>     >>> sans alourdir les pages par des « si ceci et pas cela alors »
>     >> J'ai survolé vite fait le code de la page et le contenu. Je n'ai pas l'impression de trouver de partie
>     spécifiques à
>     >> l'architecture qu'ils décrivent.
>     > Je n'ai peut-être pas choisi la bonne page, mais j'en suis sûr pour avoir traduit ce Handbook avant qu'il ne soit
>     > intégré dans le wiki. Il y a des parties communes très importantes et des parties spécifiques.
>     >>> Ce que j'ai traduit, quasiment dans sa totalité, est le guide
>     >>> d'installation. Mais j'avoue avoir du mal à comprendre toutes les
>     >>> subtilités du workflow de traduction aujourd'hui. Et pourquoi on ne
>     >>> trouve aujourd'hui, pour les dernières versions de Fedora, que la
>     >>> version anglaise.
>     >> Je crois que c'est plus lié aux changements côté documentation que traduction en fait.
>     > Oui je le crois aussi, mais j'ai du mal en tant que traducteur à m'y retrouver, à un point tel que je suis parfois
>     > découragé d'intervenir.
>     >>> Quant à ce Livret destiné aux débutants, comment y arrive-t-on ? Je
>     >>> pense qu'on envoie pas les débutants sur le dépôt Pagure. Je ne pense
>     >>> pas l'avoir traduit, mais ma mémoire me trahit peut-être, car ça me
>     >>> rappelle vaguement quelque chose. Quoi qu'il en soit, je voudrais le
>     >>> lire ou le relire. Faut-il que je le construise comme l'indique le
>     >>> README du dépôt ou est-il accessible quelque part ?
>     >> Pour le moment oui, c'est dépôt Pagure. Après rien n'empêche qu'on génère un PDF ou une page Web de ce contenu en
>     >> français et qu'on mette cela à disposition sur Fedora-fr en évidence.
>     > J'essayerai de le générer pour voir.
>     >> Je pense que le but à terme pour le projet est de le rendre disponible ici : https://docs.fedoraproject.org
>     >>> C'est ce que j'aurais préféré trouver chez Fedora. Mais c'est vrai que
>     >>> ces derniers temps, le wiki de Fedora Project est devenu multilingue
>     >>> (sans ce merveilleux outil de traduction néanmoins). Mais ce wiki là
>     >>> a-t-il la même vocation que notre wiki-fr. À les lire, je ne le crois
>     >>> pas. L'audience du premier semble être  l'équipe projet, tandis que, et
>     >>> j'espère ne pas me tromper, le wiki-fr est orienté utilisateurs.
>     >> Tout à fait.
>     >> C'est pourquoi nous maintenons le wiki de Fedora-fr à part, car le projet Fedora ne met pas en avant son wiki
>     officiel
>     >> et s'en sert comme outil de communication interne.
>     >>
>     >> D'ailleurs il y avait un travail pour porter des pages du wiki dédiés aux utilisateurs vers le projet de
>     Documentation
>     >> (et donc la mise à disposition de ces articles à terme sur le site que j'ai cité plus haut).
>     >>> Donnez-moi seulement le feu vert pour un essai. Si franchement, mon idée
>     >>> est en dehors des objectifs du wiki, ou si techniquement dans les
>     >>> mécanismes du wiki ça ne marche pas, il suffira de retirer les pages. Je
>     >>> ne m'en offusquerai pas et je ne regretterai pas non plus d'avoir perdu
>     >>> mon temps. Je voudrais seulement ne pas agir en catimini en polluant le
>     >>> wiki à l'insu de tous.
>     >> C'est une bonne chose en effet de discuter de ce genre de choses avant de s'y lancer.
>     >> De mon côté tu peux essayer, il n'y a pas de problèmes. On évaluera le résultat qui j'espère sera positif. :)
>     >>
>     >> Bonne journée,
>     >> Charles-Antoine
>     > Bon alors, je vais me lancer. Mais auparavant, je vais jeter un coup d'œil à ce livret du débutant d'origine
>     tchèque.
>     >
>     > Bonne journée à tous.
>     > José
>     >> _______________________________________________
>     >> fedora-fr-doc mailing list
>     >> fedora-fr-doc at fedora-fr.org <mailto:fedora-fr-doc at fedora-fr.org>
>     >> http://mailing-list.fedora-fr.org/mailman/listinfo/fedora-fr-doc
>     <http://mailing-list.fedora-fr.org/mailman/listinfo/fedora-fr-doc>
>     >
>     > _______________________________________________
>     > fedora-fr-doc mailing list
>     > fedora-fr-doc at fedora-fr.org <mailto:fedora-fr-doc at fedora-fr.org>
>     > http://mailing-list.fedora-fr.org/mailman/listinfo/fedora-fr-doc
>     <http://mailing-list.fedora-fr.org/mailman/listinfo/fedora-fr-doc>
>
>     Bonjour,
>
>     Je vous propose une version, encore mal dégrossie et nécessitant sûrement des corrections et des amendements, de
>     ce que
>     j'entends par parcours guidé du débutant.
>
>     Pour le moment je lui ai donné un titre que me satisfait à moitié mais c'est avant tout le principe sur lequel
>     j'aimerais avoir votre avis.
>
>     Les pages de base sont des pages normales. Certaines pourraient être rendues accessibles comme des pages
>     habituelles du
>     wiki.  Pour assurer la lecture enchaînée (parcours guidé) ces pages ont un double dont le titre est simplement précédé
>     d'une étoile (*).  La page de base est simplement incluse comme un modèle et précédée et suivie par les liens de
>     page à
>     page.
>
>     Voilà le point d'entrée dont, je le répète, le titre me satisfait à moitié :
>
>     https://doc.fedora-fr.org/wiki/Avant_installation_-_Acquisition_du_savoir_de_base
>     <https://doc.fedora-fr.org/wiki/Avant_installation_-_Acquisition_du_savoir_de_base>
>
>
>
>     _______________________________________________
>     fedora-fr-doc mailing list
>     fedora-fr-doc at fedora-fr.org <mailto:fedora-fr-doc at fedora-fr.org>
>     http://mailing-list.fedora-fr.org/mailman/listinfo/fedora-fr-doc
>     <http://mailing-list.fedora-fr.org/mailman/listinfo/fedora-fr-doc>
>
>
>
>
> _______________________________________________
> fedora-fr-doc mailing list
> fedora-fr-doc at fedora-fr.org
> http://mailing-list.fedora-fr.org/mailman/listinfo/fedora-fr-doc




Plus d'informations sur la liste de diffusion fedora-fr-doc