Zeste de Savoir passe en version 1.7

• Assemblée générale de l'association Zeste de Savoir
• Programmez en langage d'assemblage sous Linux !

L'équipe des développeurs de Zeste de Savoir est heureuse de vous présenter la version 1.7 (ainsi que la 1.6), qui vient d'être déployée en production ! Contrairement à la version 1.5, la version 1.6 renoue avec les grosses nouveautés que nous vous laissons découvrir dans la section ci-dessous (quel suspense insoutenable !).

Qu'est-ce qui a été modifié ?

Pas moins de 75 tickets ont été fermés pour la version 1.6 et 79 pour la 1.7, soit au total 154 tickets !

Certes, il y a eu beaucoup de corrections de bugs, mais surtout une grosse nouveauté : la première brique de l'API est disponible avec la publication de l'API des membres. Autre chantier qui a débuté : l'amélioration des performances. Pour l'instant, c'est mineur et peu visible mais certaines pages exécutent déjà beaucoup moins de requêtes SQL qu'en v1.5.

On peut noter l'énorme travail qui a été fait : la version 1.6 a été mise en production moins d'un mois après la version 1.5 ! La 1.7 a, elle, mis plus de temps à sortir (presque un mois et demi après la 1.6) et a subi 5 mises en bêta.

Voici la liste complète des tickets pour la version 1.6 puis la 1.7 :

L'API des membres, principale nouveauté

L'API des membres permet, comme son nom l'indique, de s'interfacer facilement et naturellement avec Zeste de Savoir – ou plus exactement avec le module des membres de Zeste de Savoir.

Toute la documentation est disponible :

• sur Read The Docs en ce qui concerne le fonctionnement général ;
• sur Zeste de Savoir (il y a un lien dans le pied de page) en ce qui concerne l'interface proprement dite.

Ceux que ça intéresse pourront toujours se reporter aux spécifications d'origine décrites dans la ZEP-17.

Comme de bien entendu, qui dit API dit applications, et qui dit applications dit "autorisation", parce qu'autoriser n'importe quoi à accéder à cette API, ce serait prendre des risques inconsidérés. Vous pouvez donc demander une clé d'API ici.

À noter que tout ça sentait encore un peu la peinture fraîche en version 1.6 :

• la documentation n'avait pas encore le design de Zeste de Savoir ;
• elle n'est disponible qu'en HTTP – le bug qui l'empêche de s'afficher en HTTPS est un bug connu de Swagger (l'outil qui génère une documentation interactive) ;
• il manque 2 URL dans la doc (affichées toutefois sur une instance locale, allez comprendre) : GET /api/membres/ et POST /api/membres/ ;
• une URL est affichée alors qu'elle n'existe pas : PATCH /api/membres/.

La version 1.7 fait mûrir un peu cette documentation avec l'intégration du design de Zeste de Savoir !

Et parce qu'une API seule ne sert pas à grand-chose (même si elle est utilisée en interne), Eskimon a lancé un sujet sur les utilisations les plus originales de cette API. Certains membres se sont donc mis à faire des graphiques en jouant avec les dates d'inscription et les dernières connexions !

Les ZEPs

ZEP-25 : catégorisation des articles et tutoriels

Du fait de la proximité de cette version avec la précédente, les membres n'ont pas eu beaucoup de temps. Toutefois, Dominus Carnufex nous propose de revoir la catégorisation des articles et des tutoriels.

ZEP-04 : Nouvelle page d'accueil !

La ZEP-04, concernant la présentation de la future nouvelle page d'accueil, est enfin passée au stade de développement ! Les deux contributeurs principaux, à savoir Situphen et Sandhose, dégagent doucement du temps pour pouvoir délivrer cette nouvelle page le plus tôt possible. Nous leur souhaitons bon courage en tout cas puisque cette ZEP est très demandée depuis un petit moment maintenant.

ZEP-12 : refonte du principe des tutoriels et articles

La ZEP-12 n'apporte pas forcement beaucoup de changements visuels, mais c'est tout le moteur des tutoriels et des articles qui a été revu. En effet, grâce à ce développement les incohérences de jeunesse entre articles et tutoriels vont disparaître, rendre la maintenance plus propre et simple pour les développeurs et le tout va permettre de casser la structure actuelle des tutoriels pour permettre de concevoir votre propre structure ! C'est un travail de longue haleine qui touche doucement au but, au grand soulagement de pierre-24 et artragis. Bravo les gars !

ZEP-05 : Refonte du traitement markdown pour l'export

Via la ZEP-05 ce sont les exports de contenu (tutos et articles) dans des formats hors-ligne (pdf, ebook…) qui sont concernés. Notre fantôme adoré, Kje, travail à améliorer l'outil gérant ces exports et rendre le tout plus flexible, notamment pour adapter les balises propres à ZdS. Dans une étape suivante, des passionnés de $\LaTeX$ seront mis à contribution pour aider à la mise en forme du contenu. Si vous avez des compétences dans ce dernier domaine, sachez que vous pourrez aider Kje avec votre expertise. Toutes les aides sont les bienvenues sur toutes les ZEP, ne l'oubliez pas.

Les problèmes récents

Vous êtes nombreux à l'avoir remarqué mais Zeste de Savoir a subi quelques perturbations ces derniers jours et vous avez le droit de savoir ce qu'il en retourne. Le mercredi 15 avril, le site a été inaccessible puis fortement ralenti pendant environ 3 heures. Au vu de la proximité de ces perturbations et de la mise en production de la version 1.7 de Zeste de Savoir, l'équipe technique pensait naturellement que cette dernière version en était la cause. Quelques recherches ont été faites et un bug dans les messages privés aurait pu causer ces ralentissements. En effet, la pagination n'était plus cohérente et certains messages privés contiennent plusieurs centaines de messages. Cela a causé une surcharge du serveur et a entrainé son plantage. Une correction a été rapidement proposée mais force a été de constater que le serveur souffrait toujours des lenteurs.

Alors d'où venait le problème ? L'équipe technique s'est tournée vers le serveur et son hébergeur. Avec l'aide des administrateurs systèmes de Zeste de Savoir, nous avons remarqué quelques métriques incohérentes qui pouvait nous laisser penser que la cause pouvait bien provenir de notre serveur, et plus précisément d'OVH, notre hébergeur. Après contact avec OVH, nous avions la confirmation que les perturbations provenaient bien de chez OVH suite à certaines manipulations de leur part sur notre VPS. Bilan des courses :

1. Nous nous sommes lancés dans la recherche d'un nouvel hébergeur (lien).
2. Gandi propose une formule d'hébergement pour soutenir certains projets (lien).

Pour l'instant, tout est revenu à la normale mais nous ne sommes pas encore à l'abri d'un nouveau problème du même genre. Nous restons donc vigilants et nous recherchons activement une autre solution.

Les choses à venir

Vous souhaitez contribuer à ZdS ?

Si vous avez l'intention de vouloir contribuer au support technique de Zeste de Savoir, c'est le bon moment puisque l'organisation de la documentation du projet open-source a été revue et le contenu a pris de la masse !

Teasing

Dans la prochaine version, nous passerons à Django 1.7 ! Nous travaillons bravement sur la migration vers Django 1.8 ainsi que le changement de Python 2 à Python 3 qui marquera alors le passage à la version 2.0 de la plateforme. Pour vous les visiteurs, rien de visuel ne changera mais d'un point de vue technique, c'est récupérer un énorme retard que nous avions pris sur les dernières versions des technologies que nous utilisons quotidiennement.

Le mot de la fin

La version 1.6 a apporté 255 commits et a modifié 382 fichiers (7,640 additions et 7,399 suppressions) ! La version 1.7 est moins conséquente avec 226 commits et 145 fichiers modifiés (3,354 additions et 2,146 suppressions).

• Assemblée générale de l'association Zeste de Savoir
• Programmez en langage d'assemblage sous Linux !