[chronique]Zest Of Dev 10
Il y a eu une petite coupure le vendredi 16/11. Et puis il y a eu la version 27.3. Cette version sonne le coup d’envoi du futur de zds. Alors c’est parti !
Un peu d'organisation
Le développement technique de Zeste De Savoir doit répondre à deux grands défis :
- organiser le développement, à 100% bénévole et sur le temps libre des gens (on n’a pas de fondation pour nous aider à embaucher des permanents…);
- faciliter la vie d’une communauté qui a déjà révolu 4 années et qui continue de grandir.
Après le départ de l’équipe technique de spacefox et vhf/cepus qui ont réussi avec brio à assurer que ces deux objectifs étaient atteint, il faudra avouer que nous avons tâtonné.
Les ZEP ont été abandonnées et nous avons décidé de fournir deux fonctionnalités majeures à chaque grosse version du site et force est de constater que… tout cela s’essouffle déjà après la v28. Est-ce parce que notre logiciel est globalement acceptable? Au vue de la capacité de certains membres à produire de très belles suggestions, je pense qu’on peut vraiment aller plus loin, mais nous avons besoin de vous pour savoir ce que vous désirez.
En attendant, nous avons désormais des ebooks de qualité acceptables tant au format epub qu’au format pdf.
les bugs des ebooks
Plusieurs bugs ont été identifiés sur les ebook (merci Eskimon et ache), certain seront facilement gérables (l’intro qui devrait être vraiment une intro et non une partie dédiée par exemple), d’autres demanderont de faire des choix complexes.
J’essaie de contacter les auteurs par MP quand un PDF/ebook n’est pas produit.
En attendant voici quelques bugs déjà découvert :
- lorsqu’un contenu contient une image externe qui n’est plus accessible, mais que le serveur répond une page html, zmarkdown télécharge le html et latex ne sait pas quoi faire de cette image, le pdf n’est pas produit
- lorsque vous mettez un bloc de code dans une note bas de page, le pdf n’est pas produit
- dans certains big tuto qui demande plus de 10 secondes à zmarkdown pour générer le latex, la connexion se coupe, le latex (et donc le pdf) ne sont pas produits
- pour les vieux tuto (notamment celui de micmath sur les équation) qui n’ont pas mis à jour les formules de math, le pdf n’est pas produit
- le lien vers le latex est mal affiché, j’ai dû faire un typo dans le template, veuillez m’en excuser
- dans les big tuto, les titres des chapitres qui ne sont pas prêts apparaissent dans le PDF (mais pas le texte, donc vos prises de note n’apparaissent pas)
- on est encore en discussion pour améliorer le rendu PDF des tableaux les plus larges
- lorsqu’un tuto n’a qu’un seul auteur, le PDF ne l’affiche pas
la v28 et ses mineures
Mais comment coordonner les efforts des bénévoles? Là est la question. Suite au retour très enrichissant de gasche, voici comment la v28 sera gérée :
- dès aujourd’hui la branche release_v28 a été créée sur le dépôt principal, lorsque sandhose
en aura marre que je le ping sur IRCaura le temps (je rappelle qu’il est étudiant et donc un emploi du temps qui n’est pas du tout uniforme) il mettra cette version en béta - très rapidement, je vais créer des tickets sur les bugs bloquant la sortie de la version et les "nice to have" (je l’expliquerai après)
- si quelqu’un veut en parallèle développer une fonctionnalité/fixer un bug, il peut le faire, et sa PR sera mergée dès que la QA est OK sur master.
Quoi qu’il arrive TOUTES LES PR doivent être faite sur master, et je me chargerai de faire du cherry-pick vers relase_v28 quand les fix concerneront des tickets bloquant/nice to have.
la v29
Pour la v29, j’ai donc un petit framadate à vous fournir, fermeture le 15 décembre :
https://framadate.org/vTARMpF7m66BkXw7
La v28: l'important, le cool, le peut -être
Cette partie sera plus synthétique mais le but est de vous donner un point d’avancement :
Bloquant pour la v28.0
- il est (de nouveau?) nécessaire d’avoir la dépendance selenium d’installée pour que la prod démarre, c’est pas bon;
- les filtres de recherche ne fonctionnent plus (https://github.com/zestedesavoir/zds-site/issues/5107)
- (à compléter)
Peut être en v28.0, sinon en v28.1
- correction de l’introduction sur les pdf
- katex 0.10.0 (dépend de comment j’arrive à intégrer la nouvelle version à zmd)
- le smiley
:popcorn: - l’option —speed pour gulp (histoire de pouvoir tester le front plus rapidement)
- style pour les parties non prête à la validation dans la béta
Forcément en v28.1 et pas après
- django 2.x (il y a des bugs que cette version seulement corrige)
- le texte dans l’éditeur persiste
- refacto de la page des membres
dans la branche 28.x
- l’api des contenus
- (à compléter en fonction des discussions)
