Aller au contenu | Aller au menu | Aller à la recherche

Dans les entrailles du Libre

Mot-clé - Documentation

Fil des billets - Fil des commentaires

sam., 25/11/2017

Compte rendu mensuel de la documentation francophone, numéro 3

Pour rappel, vous pouvez consulter l'état du travail en cours sur la documentation.

Les sujets traités ont changé quelque peu depuis la dernière fois. C'est plus centré autours des thématiques :

  • Le noyau et composantes basses ;
  • La sécurité et autres utilitaires ;
  • L'usage serveur de courrier.

Personnellement je me suis occupé plutôt des deux premiers thèmes. En effet même si le noyau Linux ne change pas fondamentalement, ses correctifs majeurs et sa procédure de compilation ont un peu changé. Ils ont nécessité un petit rafraîchissement. De plus, avec Fedora 25 qui a inauguré avec Wayland par défaut, il a fallu lui dédier un nouvel article pour familiariser les utilisateurs avec cette technologie.

Concernant le deuxième point, il était nécessaire de revoir la liste des logiciels pour chaque usage sur notre système préféré. Si les éditeurs d'images ou suites bureautique n'ont pas beaucoup changé en 5 ans, on ne peut pas en dire autant des clients de messagerie ou des navigateurs Web. Ces secteurs ont été très dynamiques avec beaucoup de projets obsolètes et de nouveaux venus. Pour la sécurité, deux outils majeurs que sont gnupg et ssh ont évolué. Surtout le premier avec sa version 2. Maintenant c'est corrigé. Nicolas a amélioré la sécurité des connexions VNC à travers SSH.

Enfin, la FAQ a été modernisée un petit peu les effets 3D de bureau sont passés de mode et systemd a remplacé le concept des niveaux d’exécution.

Le dernier point a été particulièrement étudié par Nicolas comme d'habitude, car Fedora a bien entendu un usage serveur important dont le paysage a changé. Cela commence par bien sûr parler de sendmail ou d'effectuer les redirections des courriels.

Mais son apport le plus important a bien sûr été la refonte de l'énorme article sur les serveurs de messagerie. Un article tout en un très complet qui a bénéficié d'un grand ravalement de façade. Bravo !

Je remercie également les autres contributeurs, relecteurs ou toute autres personnes qui se sont impliquées dans ce processus comme Édouard et d'autres.

Aujourd'hui donc, nous sommes à 55 articles traités, contre 42 au précédent bilan. Je suis satisfait des progrès réalisés sur la documentation. Il y a beaucoup de travail à mener encore, mais il semble possible que la documentation soit dans un état très acceptable bientôt. Ensuite il faudra veiller à maintenir la documentation à jour continuellement et ajouter des articles suivant les besoins du moment.

Je vous invite en tout cas à nous donner un coup de main, pour cela je vous conseille de suivre la procédure pour contribuer à la documentation et si possible de participer à nos ateliers hebdomadaires tous les lundi soir à partir de 21h (heure de Paris) sur le canal IRC #fedora-doc-fr du serveur Freenode. Rien ne vous empêche de contribuer en dehors du cadre des ateliers, toute l'aide est la bienvenue. Alors, n'hésitez pas !

dim., 17/09/2017

Bilan mensuel de la documentation francophone de Fedora-fr.org, numéro 2

Pour rappel, vous pouvez consulter l'état du travail en cours sur la documentation.

À cause des vacances et d'autres histoires personnelles, j'ai loupé le bilan d'août et j'ai moins contribué que la période juin-juillet. En cette rentrée, faisons quand même un bilan du travail abattu depuis deux mois.

Les sujets traités ont changé quelque peu. C'est plus centré autours des thématiques :

  • Les dépôts externes ;
  • La création de médias personnels et leur exploitation ;
  • L'usage serveur.

Personnellement je me suis occupé plutôt des deux premiers thèmes. Par exemple le dépôt de RPMFusion et les paquets multimédia qu'il propose sont un incontournable auprès des utilisateurs de Fedora. Il était important de s'y atteler car de nombreux paquets ont évolué, que ce soit des nouveaux venus, des évolutions majeures comme plus de codecs accessibles via mplayer ou GStreamer.

Concernant le deuxième point, il était nécessaire de revoir les procédures pour exploiter kickstart qui a évolué (notamment depuis l'apparition des Spins et des produits Server, Workstation et Cloud). Les moyens de télécharger Fedora ont changé, le Live CD a peu à peu laissé place au Live USB qui a été particulièrement mis en avant avec l'outil Fedora Media Writer. D'ailleurs l'installation d'un dual Boot avec Windows a aussi beaucoup évolué, car GRUB a changé avec sa version 2 ce qui a simplifié la procédure et Windows est aussi plus conciliant sur ce genre de cohabitation.

J'ai également rafraîchi la page d'aide pour contribuer à Fedora, car depuis le temps les sujets ont évolué, de nouvelles ressources ou secteurs ce sont développés comme l'assurance qualité et l'ajout aussi de la documentation francophone jusqu'ici absente.

Le dernier point a été particulièrement étudié par Nicolas, car Fedora a bien entendu un usage serveur important dont le paysage a changé. Outre MySQL devenu MariaDB, de nombreuses commandes ont changé avec l’évolution des outils. Si l’environnement web LAMP est surtout concerné, cela touche également SELinux, le serveur de courriel Dovecot et Openldap. Un énorme travail a été accomplis, donc merci à lui !

Je remercie également les autres contributeurs, relecteurs ou toute autres personnes qui se sont impliquées dans ce processus comme Édouard, Nicolas Chauvet, et d'autres.

Aujourd'hui donc, nous sommes à 42 articles traités, contre 25 au précédent bilan. Je suis satisfait des progrès réalisés sur la documentation. Il y a beaucoup de travail à mener encore, mais il semble possible que la documentation soit dans un état très acceptable d'ici Fedora 27 ou la fin de l'année 2017. Ensuite il faudra veiller à maintenir la documentation à jour continuellement et ajouter des articles suivant les besoins du moment.

Je vous invite en tout cas à nous donner un coup de main, pour cela je vous conseille de suivre la procédure pour contribuer à la documentation et si possible de participer à nos ateliers hebdomadaires tous les lundi soir à partir de 21h (heure de Paris) sur le canal IRC #fedora-doc-fr du serveur Freenode. Rien ne vous empêche de contribuer en dehors du cadre des ateliers, toute l'aide est la bienvenue. Alors, n'hésitez pas !

lun., 17/07/2017

Bilan mensuel de la documentation francophone de Fedora-fr.org, numéro 1

J'ai décidé d'essayer de publier un bilan mensuel de l'état d'avancement des travaux de la documentation francophone de Fedora-fr. Ce bilan compilera en somme les bilans hebdomadaires envoyés sur la liste de diffusion.

Tout d'abord, nous avons catalogué les pages à traiter suivant l'état actuel des pages pour déterminer l'étendu du travail à mener sur chacune. Ensuite chaque page sera mise à jour afin d'être compatible avec les versions de Fedora récentes quitte à supprimer les passages concernant les versions plus anciennes, n'étant plus supportées. Ce qui rendra la documentation plus claire et utile.

Ensuite, les travaux se sont concentrés surtout autour de trois axes :

  • Les premiers pas d'un utilisateur ;
  • Le matériel ;
  • Le réseau.

Le premier cas était sans doute prioritaire, les nouveaux utilisateurs de Fedora ne pouvaient pas débuter avec notre documentation qui était bien trop ancienne. La procédure d'installation a été profondément remaniée, GNOME 3 a subi des changements non négligeables depuis ses débuts, la procédure de mise à niveau également. Les dual-boot avec Windows, via GRUB2, ont aussi changé, cela s'est considérablement simplifié.

Enfin, dnf a remplacé yum pour gérer les paquets ce qui rend beaucoup de manipulations de fait obsolètes. Les pages doivent s'adapter à cette nouvelle donne pour simplifier la vie des lecteurs.

C'est pourquoi je me suis attelé sur ces articles en premier afin qu'un curieux puisse être le plus autonome possible.

Le second cas est dû à l'évolution du matériel opérée depuis 5-6 ans. Les SSD s'imposent peu à peu tout comme les systèmes type Optimus, les pilotes graphiques libres et proprio ont également beaucoup changé (positivement bien entendu). Mettre à jour ces sujets permet de mieux servir le lecteur par rapport à ses besoins d'aujourd'hui. Nicolas a beaucoup travaillé sur la question et je le remercie car cela devenait nécessaire.

Il faudra peut être compléter cela par des articles à propos de Wayland ou libinput par exemple qui ont un impact non négligeable sur la couche graphique et des entrées / sorties du système.

Le troisième cas reflète les améliorations apportées par NFS depuis mais aussi le pare-feu de Fedora qu'est firewalld. Ce dernier n'étant globalement utilisé que dans l'écosystème Fedora / RHEL, la documentation existante en français reste assez pauvre, il est important de pouvoir guider pour apprendre son fonctionnement de base.

Nicolas là encore a beaucoup œuvré sur ce point. Merci à lui.

À l'heure actuelle, en un peu plus d'un mois de travail à 2 (+ quelques relecteurs et contributeurs dont l'aide est toujours appréciée), près de 25 articles ont été traités. Et il y a encore beaucoup à faire. Dans notre première estimation du travail à mener, près de 45 articles restent à gérer. Et beaucoup d'autres pages n'ont pas été incluses dans cette procédure, une nouvelle itération aura lieu pour s'en charger.

Et c'est sans compter les pages à créer pour traiter des situations nouvelles et répondre aux besoins des utilisateurs comme Wayland ou Flatpaks.

En tout cas je suis satisfait des progrès réalisés sur la documentation. Il y a beaucoup de travail à mener encore, mais il semble possible que la documentation soit dans un état très acceptable d'ici Fedora 27 ou la fin de l'année 2017. Ensuite il faudra veiller à maintenir la documentation à jour continuellement et ajouter des articles suivant les besoins du moment.

Je vous invite en tout cas à nous donner un coup de main, pour cela je vous conseille de suivre la procédure pour contribuer à la documentation et si possible de participer à nos ateliers hebdomadaires tous les lundi soir à partir de 21h (heure de Paris) sur le canal IRC #fedora-doc-fr du serveur Freenode. Rien ne vous empêche de contribuer en dehors du cadre des ateliers, toute l'aide est la bienvenue. Alors, n'hésitez pas !

dim., 18/06/2017

Le nettoyage de la documentation francophone a débuté !

Il y a 3 mois, j'avais annoncé la volonté de nettoyer la documentation francophone de Fedora pour tenir compte des évolutions de la distribution depuis 2011-2012.

Le travail a commencé, nous avons recensé le travail à effectuer dans une page wiki dédiée afin de relancer la machine, les premières contributions arrivent ce qui est bien. :-)

Afin d'inciter les contributions, nous avons mis en place une réunion hebdomadaire chaque lundi à 21h (heure de Paris), après la réunion hebdomadaire de Fedora-fr en fait. Cela se passe sur le canal IRC #fedora-doc-fr sur serveur FreeNode.

Ainsi durant la soirée nous essayons de nous coordonner sur ce qu'il y a à faire, se relire, rédiger, corriger, etc. Nous avons commencé la semaine dernière et cela s'est bien passé. Le travail devrait prendre quelques mois pour parvenir à une situation convenable en terme de mise à jour.

Vous pouvez suivre le chantier sur la liste de diffusion dédiée à la documentation, dont les archives sont disponibles. J'y fais un compte rendu chaque semaine.

Si vous souhaitez nous donner un coup de main, nous vous invitons à lire la page pour apprendre à contribuer. Nous sommes également disponibles en cas de questions ou d'une aide particulière.