Licence CC BY-SA

Récap' communautaire #18 — Août 2019

Faisons le point sur l'actualité de notre communauté !

Dernière mise à jour :
Auteurs :
Catégorie :
Temps de lecture estimé : 30 minutes

Nous sommes maintenant en septembre, l’heure de la rentrée est (malheureusement ?) venue, mais également celui du récap' !

Petit rappel habituel avant de commencer : la rédaction du prochain récap' a déjà démarré et est ouverte à tous. On vous donne rendez-vous sur le sujet de la bêta.

Le coup de projecteur

Ce mois-ci, @A-312 nous a présenté son module NodeJS nommé serverline permettant de ne pas avoir l’entrée clavier coupée par la sortie de texte en console.

Fonctionnement de serverline
Fonctionnement de serverline

Sur le sujet dédié, il explique comment il y est parvenu à l’aide du caractère de retour chariot (\r) ainsi que des séquences d’échappements permettant de manipuler le comportement du terminal. N’hésitez pas à aller voir son projet et à l’aider dans son amélioration.

Du côté des forums

@Peyote a commencé la rédaction d’un tutoriel intitulé « Installer PySide2 dans Blender ». À terme, celui-ci vous permettra de créer des interfaces graphiques directement dans Blender à l’aide de la bibliothèque logicielle Qt ! N’hésitez pas à l’aider pour la rédaction ou à le relire sur le sujet dédié.

@Eskimon se tâte quant à la pertinence de diffuser des vidéos en direct pour faciliter l’apprentissage de la programmation avec Arduino. Vous pouvez lui donner votre avis sur ce sujet.

Ce mois-ci ce ne sont pas moins de 4 rendez-vous communautaires qui ont eut lieu : deux JZdS, un deuxième ZRédigeons ensemble ainsi qu’un rendez-vous des développeurs du site. Vous pouvez suivre l’agenda des prochains rendez-vous en suivant cet agenda préparé par @Situphen pour tous les recenser dans le futur.

Les contenus du moment

Si on exclut le récap' communautaire de juillet, il n’y a pas eu de publications d’articles ou de tutoriels ce mois-ci.

Heureusement, le mois prochain, les auteurs et les validateurs font leur rentrée, et il est certain qu’il y aura des choses à se mettre sous la dent pour les lecteurs les plus assidus. La publication de certains contenus est dors et déjà imminente ! :)

Billets

Les billets étant une forme de publication plus libre, le mois d’août a tout de même vu trois billets publiés !

@informaticienzero nous présente un récit du point de vue d’un protagoniste du jeu vidéo Star Wars Battlefront II ; il l’a retrouvé sur un vieux disque dur et il rejoint la lumière sur Zeste de Savoir.

@rezemika explique comment accéder au savoir scientifique, qui est parfois perçu comme inaccessible, alors qu’il existe plein de solutions pour y accéder facilement.

@TAlone plonge dans les détails de la gestion de l’échappement dans markdown. Avis aux amateurs !

News des dev

Ce mois-ci fut un mois bien plus actif que les deux précédents !

Grâce à une forte activité de la communauté, nous avons pu découvrir de nouveaux bugs dans notre système de génération des PDF et des epubs. De ce fait, plusieurs bugs ont déjà été résolus et d’autres résolutions vous seront livrées en septembre.

D’ailleurs septembre sera le mois de la 28.2. Cette dernière vient d’être déployée sur la bêta et sera donc mise en production durant le mois de septembre.

Ce que vous trouverez dans la v28.2

  • Correction des epubs pour que tous soient fonctionnels et avec un style qui soit lisible. À l’heure actuelle seuls les mathématiques ne sont pas encore aussi bien rendus que sur le site et surtout les blocs secrets.
  • Améliorations sur le SEO et l’accessibilité, bien que nous n’ayons pas réussi à en intégrer autant que nous le désirions, des améliorations ont été développées tant sur les forums que sur les contenus. Le travail sur l’accessibilité continuera, évidemment, la devise de ZdS reste « la connaissance pour tous et sans pépins ».
  • Création d’une toute nouvelle page de profil plus navigable, plus claire et qui a été maquettée de manière communautaire.
  • Petite amélioration d’ergonomie dans les galeries, notamment sur la suppression des images.
  • Chargement intelligent de Mathjax : il n’est chargé que si on en a besoin et ce quelle que soit la page, ça réduira une grande partie du temps de chargement.
  • Le générateur d’export de contenu a été revu de fond en comble pour être plus fiable et plus performant.
  • Ajout de la possibilité de signaler un profil (pour les profils de spammeur)
  • Amélioration des imagettes twitter.

Et zmarkdown?

Le développement de zmarkdown continue en parallèle de celui du site. Le mois dernier vous avez eu droit à Soundcloud par exemple. Ce mois-ci c’est surtout le debug qui a pris du temps aux contributeurs. Cependant, de nouvelles fonctionnalités arriveront. À ce propos, n’hésitez pas à émettre des suggestions en fonction de vos besoins.

Deux discussions ont été lancées sur notre discord pour implémenter dans zmarkdown des outils qui peuvent être utiles aux auteurs :

  • mermaid : c’est un outil qui génère des diagrammes à partir d’un texte plat.
Exemple de diagramme
Exemple de diagramme
  • abc.js (ou une alternative) : c’est un outil qui génère des partitions (et leur interprétation vidéo !) à partir d’un texte.

Pour l’instant, il ne s’agit que de discussions car nous ne savons pas si ces outils seront utilisés de façon généralisée, mais cela peut être des fonctionnalités que les contributeurs prendront goût à développer.

Enfin, un gros travail de suivi de version est en cours sur zmarkdown : remark (la base de zmarkdown) est passé en version 6 ce qui amène pas mal de debug, mais aussi des nouvelles fonctionnalités. Par exemple, vous allez bientôt pouvoir mettre en exergue des lignes particulières dans votre code, car les marqueurs hl_lines et line_no_start seront supportés dans remark (jusqu’à présent, ils n’étaient supportés que par rebber car nous avions utilisé une astuce).

Zds-meeting

Ce mois-ci a eu lieu un ZdS-meeting, le rendez-vous des développeurs du site. En voici le compte-rendu final.

Les personnes participantes lors de ce Zds meeting (26 août 2019 à 19h sur Discord) étaient : A-312, Amaury, Artragis, Situphen, Philipmilink, Gustavi, Vanadiae, sTAlone et AmarOK (soit un total de neuf personnes !).

cf. mon VDD pour l’ordre du jour

Le compte-rendu

La version 28.2 est pas finie depuis longtemps Premier ménage fait pour éviter de rester trop longtemps, on arrive à la fin On va enlever la partie API tutos, pas le temps de replonger, trop longtemps dessus à faire des rebases, un peu compliqué trop à faire On est bien partis pour faire une vraie 28.2 en bêta @artragis aurait bien aimé le nouveau ZMD mais VHF (@cepus) n’a pas release, donc on va quand même mettre en bêta pour diffuser 28.2 en septembre Donc il reste plus grand-chose à faire (transcript) Pour la v29, deux grosses fonctionnalités : parcours et nouvelle interface de validation avec les suggestions

Validation : idée de @A-312 : pouvoir laisser des notes dans le contenu (au niveau de la partie ou du paragraphe) un peu comme Word pour éviter les MPs ultra longs, genre annotation, genre review sur GitHub

Parcours : pour l’instant on a tous une idée différente donc faudrait le spécifier pour s’ajuster Artragis a son idée à lui et on a pas envie de faire des tensions comme les tribunes au moment de la sortie, donc on va d’abord refaire un point sur la vision de chacun des parcours pour derrière faire un compte rendu et avoir une synthèse des idées pour aller sur quelque chose de bien défini (prise de décision, pas ajout de tout ce qui est dit, mais en prenant tout en compte ofc) Sinon y’a aussi la liste de lecture : Artragis la voit comme un truc qui se branche sur les parcours, fonction de son idée des parcours, par contre ça ne fait pas encore trop l’unanimité donc on va le mettre en feedbacks

Le reste c’est du bugfix et de l’amélioration, notamment de l’interface de validation, cf. sujet pour avoir des maquettes afin d’avoir un système plus simple, avec tout sauf l’éditeur pour ne pas se perdre, l’éditeur ce sera la version suivante. Jouer sur la sélection de licence et des demandes d’aides pour alléger les pages, par exemple sortir les demandes d’aide et les licences des pages principales pour les mettre à côté pour alléger le tout et ne les demander qu’à la mise en bêta / validation Avec pour les licences un wizard pour les CC et éventuellement autre chose pour les autres licences (genre tous drtois réservés mais en précisant, genre que c’est toutjours accessible gratuitement mais que la diffusion est polus restreinte) V30 : un éditeur à la codemirror, et pour les billets et les articles, un unique champ pour tout écrire vu qu’on a ps besoin de plus

@Amaury (merci pour tes pavés au passage ;) )

Centralisation de l’avancement des tâches -> https://github.com/zestedesavoir/zds-site/projects

Exercices (objectif v30 ?):

→ Des premières idées de développements progressifs pour les exercices, avec d’abord juste des QCM, puis ajouter des textes libres, puis des textes à trous…
→ Exercices uniquement côté client : on s’en fout de stocker (ou même donner) des notes, l’objectif est juste de s’auto-évaluer, pas de faire des MOOCS avec des certificats, etc.
→ Première version des modules d’exercice (avec QCM) à proposer à la communauté pour la V30 (en demandant les fonctionnalités désirées par la communauté), puis en fonction de l’usage concret des exercices, améliorer petit à petit dans les versions ultérieures en ajoutant plus de types de questions ou autres.
+1 sur le plaisir d’installer ZdS Quand ça va pas j’installe ZdS depuis zéro et ça va mieux

  • zestedesavoir.com/forums/sujet/12901/suggestion-cocher-les-listes-depuis-laffichage/ ?

Attirance de ZdS aux nouveaux contributeurs :

@AmarOk => l’accompagnement / mentorat

Accueil des nouveaux

→ refaire la doc pour qu’elle devienne un point d’entrée vers toutes les ressources
→ la doc doit expliquer mieux comment contribuer, comment installer un environnement, contribuer, toucher à tel module, etc.

@Situphen a commencé ça :

J'avais commencé une structure il y a de ça quelques mois (il faudrait que je me replonge dedans) :

- Présentation du Projet ZDS
      - Notre projet principal, zds-site
      - Aperçu des projets de secondaires
- [Tutoriel] Je fais mes premiers pas
      - Récupérer le code source (cloner le dépôt, clés SSH, git clone...)
      - Installer le projet rapidement (commandes make install-*)
      - Préparer le terrain (mettre à jour les dépendances, python manage.py migrate, builder le front, créer des fixtures)
      - Lancer le site web (lancer zmarkdown, lancer le serveur)
- [Tutoriel] J'explore un peu plus en profondeur
      - Utiliser la recherche (lancer ElasticSearch, indexation des contenus)
      - Générer PDFs et EPUB
      - Autres commandes du manage.py (nettoyage des alertes et notifications, générer rapports de release...)
- [Tutoriel] Je fais ma première contribution (tests unitaires, Travis CI...)
      - Fonctionnement du projet (code de bonne conduite, workflow général, utilisation des tickets et PRs)
      - Proposer une nouvelle fonctionnalité ou une correction de *bug*
      - Vérifier une proposition de code source d'un autre contributeur
 - Installation et utilisation avancée
      - Installation détaillée sous Linux
      - Installation sous Windows (obsolète)
      - Installation sous MacOS (obsolète)
      - Installation du frontend
     - Installation de zmarkdown
      - Installation de ElasticSearch
      - Installation de LaTeX et de latex-template
      - Configuration des serveurs de production
Backend
Doc technique du backend
Frontend
API
Autres outils

→ améliorer l’installation sous Windows
→ docker why not mais pas une priorité et attention à la maintenance
→ améliorer le README pour qu’il soit plus clair sur comment contribuer et qu’est-ce qu’est ce projet
→ étiqueter les tickers avec good first issue ou équivalent, contacter GH pour que la page https://github.com/zestedesavoir/zds-site/contribute liste les bonnes (et pas C-Docs :D), et mettre cette page en avant dans la doc (cf. tickets "Facile")
→ mettre en avant sur le site : le dépôt, la doc, Discord; afin qu’on puisse plus facilement trouver le moyen de contribuer

Bonus

Deux autres sujet par @gustavi

  1. Il a un bon plan pour profiter d’une offre gratuite sur une solution qui fait de l’analyse SEO un peu poussée, il reviendra en parler dans les semaines qui arrivent avec plus de détails. → à voir si ça nous intéresse, ça sort des stats qui peuvent être intéressantes Ça peut ne rien sortir comme sortir 1 milliard de choses et on pourrait s’en servir pour améliorer les points où c’est utile Il en parle et nous tient au courant sur les jours/semaines qui arrivent

  2. Coût de l’infra : points à discuter avec le @CA (je ping @nohar et tout le @CA (peut-on faire ça d’ailleurs ?), en privé (rien d’extraordinaire juste pour pas encombrer la réunion)

Zmd

  • hl_lines
  • line_nostart

@sTAlone :

graph TB
A((round)) --> B(Rounded)
B --> C[Square]
C --> D{Diamond}
C --> E>Strange]

@Amaury a proposé de regarder du côté de cet outil https://github.com/Khan/tota11y

Le plan pour la suite

Nous commençons donc le développement de la v29. Cela signifie donc l’arrivée de l’interface d’annotation pour la validation des tutos ainsi que des parcours.

État de ces deux fonctionnalités

Le travail sur la première fonctionnalité devrait commencer rapidement, on sait ce qu’on veut, ça ne sera pas facile, mais ça devrait aller.

Pour les parcours, tout le monde en veut, mais personne n’est d’accord sur ce qu’est un parcours. Du coup, nous allons faire appel à la communauté pour savoir ce que vous désirez réellement et artragis (le mainteneur du projet) fera la synthèse et prendra la décision de ce que ça sera et de comment ça apparaîtra.

A cause du temps de concertation, il est possible que l’interface d’annotation arrive avant décembre, alors que les parcours ne seront encore que balbutiants. Dans un tel cas, nous lancerions la v29 avec seulement l’interface d’annotation et les parcours arriveront en v29.1.

Le reste

Nous allons continuer le travail de l’amélioration de l’interface de rédaction. Le premier pas est arrivé en v28 (meilleurs explications, le drag and drop…), mais on va encore aller plus loin. La seconde étape intégrera des champs textes plus grands pour rédiger (car franchement 10 lignes c’est trop peu), mais surtout une refonte des pages de configuration des tutoriels.

Une nouvelle fois nous faisons appel à la communauté pour obtenir une maquette qui soit aux petits oignons. Nous faisons tout pour ne pas subir le problème le plus commun des logiciels libres : le manque d’investissement dans l’ergonomie.

D’autres fonctionnalités sont prévues (flux RSS des notifications, images SVG dans les galeries…), mais sont moins prioritaires que ce qui précède.

Certains développeurs planchent aussi déjà à intégrer des exercices simples à la v30. :)

Un récap', des stats'

Le top 10 des contenus lus sur Zeste de Savoir

Du 1er août au 26 août 2019.

Tutoriels

Articles

Billets

Forum

Visiblement l’équipe de modération a beaucoup travaillé durant le mois d’août.


Dernier rappel avant de se quitter : la rédaction du prochain récap' a besoin de volontaires ! On attend vos suggestions sur le sujet de la bêta.

1 commentaire

Vous devez être connecté pour pouvoir poster un message.
Connexion

Pas encore inscrit ?

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