Licence CC BY

ZdS passe en version 1.1 quelques jours avant son anniversaire

Un bref aperçu des nouveautés

Le dimanche 02 novembre sera un jour particulier, car nous fêterons l'anniversaire du premier commit sur le dépôt officiel du site de Zeste de Savoir. La communauté de Zeste de Savoir croit énormément à l'Open Source, et une vue d'ensemble de l'année nous montre tous les jours que nous avons eu raison d'y croire, car en termes de développement, le projet représente :

  • 3 302 commits faits par 46 contributeurs, ce qui représente environ 41 313 lignes de code ;
  • selon la méthode DOCOMO, pour estimer l'effort déployé pour réaliser un projet, le code source de ZdS c'est 10 années/homme de travail, autrement dit, ce qu'une personne arrive à faire en 10 ans, nous l'avons réalisé en 1 an grâce au travail de tous.

Pour faire une comparaison de l'activité de développement de ZdS par rapport à d'autres gros projets Open Source, sur les 12 derniers mois, on retrouve les chiffres suivants :

Sur les 12 derniers mois Zeste de Savoir WordPress Symfony
Nombres de contributeurs 46 22 399
Nombres de commits 3 280 3 895 3 080
Fichiers modifiés 2 089 1 191 3 680
Nombre de ligne ajoutés 655 245 294 947 274 447
Nombre de ligne supprimées 441 603 151 339 117 983

Pour un début, ZdS commence plutôt très fort, car on voit à travers ce tableau que l'activité égale celle d'autres gros projets. Cependant, comment le projet en est-il arrivé là ? C'est le moment de faire un bref récapitulatif des temps fort du développement de ZdS, et de présenter aussi les nouveautés futures. On en profitera pour parler un peu des coulisses du développement de ZdS.

La version 1.1 , des nouveaux outils pour les auteurs

Quelques semaines après le passage en version 1.0 (synonyme de stabilité du code), le code source du site est passé il y a peu en version 1.1. Cette dernière apporte un lot de fonctionnalités tirées parmi les nombreuses suggestions qui ont été demandées par la communauté.

Simplifier la tâche des auteurs

Zeste de Savoir est un site de partage de connaissance, raison pour laquelle il est très important que ceux qui produisent le contenu aient des outils adaptés à leur besoin. La version 1.1 a donc donné la priorité aux outils pour les auteurs.

Modifier un tutoriel hors-ligne et l'importer

Jusqu'ici la rédaction d'un tutoriel ne pouvait être faite que via l'éditeur en ligne. Si vous n'aviez pas de connexion réseau, il fallait rédiger votre contenu sur un bloc-notes, pour le copier/coller ensuite dans l'éditeur en ligne. Autant vous dire que ça commençait à devenir laborieux quand vous deviez modifier plus de trois extraits différents.

Aujourd'hui le problème n'est pas entièrement réglé, mais la difficulté a été grandement atténuée grâce à la possibilité d'importer une archive de tutoriel. Ce qui signifie donc qu'en tant qu'auteur, pour modifier votre tutoriel en mode hors-ligne vous pouvez :

  1. Télécharger l'archive correspondante (en cliquant sur Archive dans la barre de gauche)
  2. Décompresser l'archive téléchargée
  3. Ouvrir chaque extrait (fichier .md) que vous souhaitez modifier avec un éditeur de texte simple
  4. Appliquer et enregistrer vos modifications
  5. Zipper le dossier du tutoriel
  6. Réimporter l'archive sur le site via ce lien

La fonctionnalité étant encore jeune, elle est encore perfectible et sera améliorée au fil des versions de ZdS.

Certains outils développés par la communauté, comme Zest'Editor et ZdSReader, vous aident également à travailler en mode hors-ligne.

Importer plusieurs images dans la galerie en un clic

Il est désormais possible d'importer plusieurs images d'un coup dans votre galerie en envoyant une simple zip (Voir la documentation).

Un fil de discussion automatique pour les tutoriels en bêta

Cette nouvelle fonctionnalité permet de simplifier le cycle de vie de la bêta des tutoriels. Lorsqu'un tutoriel est proposé en bêta, un sujet est automatiquement créé et mis à jour au fil de la bêta. L'auteur n'a plus besoin de se soucier de cette tâche de communication auprès de la communauté !

Nous avons déjà eu des retours sur cette amélioration, qu'il faudra peaufiner pour les versions à venir.

Des fonctionnalités pour les membres

ZdS n'est plus une prison

Une des fonctionnalités qui manquait cruellement sur le site était la possibilité de se désinscrire soi-même. La fonctionnalité a été implémentée, et vous pouvez maintenant vous désinscrire quand vous le souhaitez. Si vous vous désinscrivez :

  • votre compte sera complètement supprimé ;
  • vos messages sur le forum seront anonymisés ;
  • vous quitterez tous les MP que vous avez en cours ;
  • les articles/tutoriels seront transmis à l'auteur externe si la licence le permet, ou supprimés s'ils étaient hors-ligne. En cas de contenus multi-auteurs, l'auteur partant est simplement retiré de la liste des rédacteurs.

Des flux RSS/ATOM taillés aux petits oignons

Il devient plus simple de suivre les mises à jour du contenu du site grâce aux flux RSS/ATOM qui ont été revus de manière à obtenir une vision assez fine. Non seulement le nombre d'entrées dans les flux est passé de 5 à 25, mais il est maintenant possible d'avoir des flux RSS/ATOM pour :

  • les nouveaux tutoriels (RSS et ATOM) ;
  • les nouveaux articles (RSS et ATOM) ;
  • les nouveaux messages dans le forum :
  • les nouveaux sujets dans le forum :

Et dans le futur ?

Eh bien, le futur s'annonce chargé ! On a déjà une jolie pile de tickets qui mêle un peu de tout, encore et toujours des bugs et suggestions. Et bien entendu, les futurs gros projets esquissés dans les ZEP !

Mais saviez-vous que vous pouviez participer au futur de Zeste de Savoir ? En effet, le projet est 100% libre ; au delà de la participation aux forums et pourquoi pas au contenu, vous pouvez :

Pour rappel, le cycle de développement sur ZdS est le suivant :


57 commentaires

Comme personne n'a répondu :

Y a-t-il un sujet expliquant précisément comment chacun peut apporter sa pierre à l'édifice et comment (pas nécessairement qu'au niveau du code : étudier les suggestions, lire les tutoriels en bêta…) ?

Vayel

Il faut déjà séparer deux choses : le site et la plateforme.

Au niveau du site il est possible de participer en faisant vivre le forum, en rédigeant du contenu (exo du forum, articles, tutos) et en commentant le contenu en beta.

Au niveau de la plateforme, il y a :

  • Le code bien entendu. Principalement en Python/Django pour le back, mais aussi en HTML5/JS/Sass pour le front. On peut rajouter aussi Haskell pour notre fork de Pandoc et latex pour les templates des pdf générés.
  • Rédiger de la doc et bientôt probablement la traduire en anglais.
  • Rapporter les bugs et suggestions du forum vers des tickets github
  • Mettre en place des outils pour aider les dev : Des script des déploiements rapide sur une machine, peut etre des container Docker tout pret, etc.
  • Faire de la QA : Cela se résume en clonnant une branche particulière en local et vérifier que les modifs faites par le dev répond bien au ticket associé ET n'introduit pas de problèmes ailleurs.
  • Tester les version en préprod (comme la 1.2 actuellement en test).
  • Aider à l'eco-système : il commence a y avoir des outils annexes de développés (les notificateurs de navigo par exemple) mais a terme, avec la ZEP sur les API, de nombreux autres outils vont pouvoir s’agréger.

Et entre les deux, nous avons les ZEP qui sont des débats et spécifications de fonctionnalités qui ont besoin de participation pour avancer.

J'en ai probablement oublié. Bref si vous voulez participer, il y a du taf. Actuellement le plus urgent est probablement des devs front (puisque Alex a moins de temps avec son nouveau taf) et des personnes en QA pour faire avancer les PR en attente.

A noter que rien n'est figé, ce n'est pas parce que vous participée quelques fois à l'une ou l'autre des catégories que vous devrez vous y confiner. Vous pouvez faire en fonction de vos envies et disponibilités. Et quelque soit votre choix, si vous voulez vous lancer, on peut trouver quelqu'un pour pour vous aider et vous guider au début, il ne faut pas avoir peur !

En fait ce qu'il faut bien comprendre c'est que "tout le monde est vraiment invité a participer". Je ne sais pas quel est le meilleur moyen pour transmettre ce message, mais le site est vraiment ouvert dans tout les sens possibles du terme, que ce soit (non exhaustif) :

  • Pour le développement
  • Pour les prises de décision sur des fonctions, comportement, design
  • Pour publies articles, tutos, sujet de forums, exercices
  • Pour donner son opinions sur le dev si on ne connait pas la technique ou en faire parti si on connait ou veux apprendre (et c'est possible, je connaissais pas vraiment python et pas du tout django il y a 6 mois)

Bref, tout le monde peut venir faire une contribution, petite ou grande, tout est bienvenu :)

(mais ca a pas l'air d’être naturel de voir un lieu ou tout le monde a le droit d'avoir son mot a dire et sera écouté :D )

(La seule chose qui ne peut pas être ouverte a tous sont les décisions financières, régient par l'association… Mais au final tout le monde qui le souhaite et veut s'investir plus intimement dans la vie du site et ses actions peut faire parti de l'assoc' aussi :) )

+0 -0

(La seule chose qui ne peut pas être ouverte a tous sont les décisions financières, régient par l'association… Mais au final tout le monde qui le souhaite et veut s'investir plus intimement dans la vie du site et ses actions peut faire parti de l'assoc' aussi :) )

Effectivement les décisions financières sont décidés par le CA de l'asso. L'asso est cependant ouverte aussi : depuis l'ouverture du site, toutes les personnes qui en ont fait la demande ont été accepté dans l'asso. Ils pourront se porter volontaire pour faire partie du CA a la prochaine assemblée. Donc ça reste ouvert, dans les limites des contraintes d'une association.

Pour tout le reste, Eskimon a tout a fait raison. Tout le monde peut participer a hauteur de ses capacités et temps de dispo. Et il ne faut pas hésiter : Si vous voulez apprendre il y aura du monde pour vous aider a rentrer dans la machine. Même sans parler de code, participer au développement d'un tel gros projet est très enrichissant. Profitez en !

Peut-être qu'un article là-dessus pourrait être intéressant. Il suffit de voir à quel point celui-ci a suscité l'engouement. ^^

L'article expliquerait ce que tu viens de dire Eskimon puis détaillerait comme l'a fait Kje, en faisant référence aux sujets concernés de la Dev zone.

+0 -0

Même sans parler de code, participer au développement d'un tel gros projet est très enrichissant. Profitez en !

Kje

C'est le point majeur à mettre en évidence.

Beaucoup d'entre vous sont sans doute jeunes diplômés ou en cours de l'être. Vous vous rendrez rapidement compte que l'expérience et la curiosité technique est le nerf de la guerre dans votre futur métier.

Echanger autour d'un projet ouvert comme celui-ci est véritablement une manne de savoir gigantesque. Vous trouverez ici toujours quelqu'un qui prendra le temps et le soin d'argumenter ses décisions pour que vous puissiez les comprendre. C'est un luxe que vous n'aurez sans doute pas souvent dans vos futurs métiers, profitez-en, posez des questions. Pourquoi tel choix technique ? Comment peut-on faire cela ? Est-ce-que telle fonctionnalité a un intérêt ? Comment pourrait-on la mettre en place ? Autant de questions qui vous feront progresser. Même si vous ne pensez-pas vous orienter vers tel ou tel domaine, profitez-en.

+9 -0

Peut-être qu'un article là-dessus pourrait être intéressant. Il suffit de voir à quel point celui-ci a suscité l'engouement. ^^

L'article expliquerait ce que tu viens de dire Eskimon puis détaillerait comme l'a fait Kje, en faisant référence aux sujets concernés de la Dev zone.

Vayel

En fait, un tuto "Comment contribuer au contenu du site ?" serait préférable. Et si l'on pouvait le garder de manière permanente sur l'accueil, encore mieux.

+0 -0

En fait, un tuto "Comment contribuer au contenu du site ?" serait préférable. Et si l'on pouvait le garder de manière permanente sur l'accueil, encore mieux.

Plutot "Comment contribuer au site ?", pour englober a la fois le contenu et la création de la plateforme technique.

C'est un vrai article de communication pour le coup.

Et pour faire plaisir à SpaceFox, on pourrait presque en faire une infographie.

"J'ai des connaissances en développement ? Oui -> … Non -> …" "J'ai envie de lire les cours en phase de rédaction : Oui -> … Non -> …" etc.

+1 -0

Je crois me souvenir d'un thread pendant la bêta quand on en était à comparer les polices de caractère et qui citait une infographie comme source. Et il me semblait que tu avais mentionné à quel point tu te méfiais des infographies "pour tout et rien".

Je peux me tromper complètement, c'était pour glisser un "poke" ;)

+0 -0

Un mélange des deux en l'occurrence. Plutôt diagramme de décision, mais présenté sous forme d'infographie (un personnage qui se gratte la tête, une bulle d'aide au-dessus de lui, dans ce style là…). M'enfin comme j'ai pas vraiment de talent dans le domaine je laisse les gens qui en ont trouver la forme la plus adaptée.

Disons juste que c'est peut-être un peu plus "viral" qu'un simple tutoriel. Mais comme le mieux est l'ennemi du bien, un tutoriel serait certainement très largement suffisant.

+0 -0

En fait, un tuto "Comment contribuer au contenu du site ?" serait préférable. Et si l'on pouvait le garder de manière permanente sur l'accueil, encore mieux.

Plutot "Comment contribuer au site ?", pour englober a la fois le contenu et la création de la plateforme technique.

Kje

Yep, plutôt ça. :)

+0 -0

Votre compte sera complètement supprimé

Youhou ! Enfin un site qui respecte mes droits :D

Evotique

En fait théoriquement le site a juste a supprimer ton compte si tu le demande, pas forcément à te proposer l'option pour le faire toi même. Mais le faire a la main c'est chiant pour les admins, c'etait plus simple pour le long terme d'avoir une option dédié. De toute façon si quelqu'un veut partir, il partira, on est pas là pour aller à la chasse aux membres, nous on souhaite que les membres soient actif.

En tout cas encore bravo a tout le monde pour le travail accompli !

Précisons que c'est de toute façon la loi en France (dite « Informatique et Libertés ») : à partir du moment où un site est accessible en France (et c'est encore plus vrai si le site est basé en France), le visiteur a le droit de demander la suppression des données le concernant. Si un site ne respecte pas ce droit, tu peux déposer une plainte auprès de la CNIL.

+0 -0

Oui oui on est d'accord mais la loi n'impose pas de proposer la fonctionnalités directement à l'utilisateur. on va plus loin que la loi là. En soit tant qu'on supprime le compte si l'utilisateur nous le demande par mail/MP, on respecte la loi. Ce qu'on avait déjà fais une fois avant que la 1.1 soit en production.

Peut-être qu'un article là-dessus pourrait être intéressant. Il suffit de voir à quel point celui-ci a suscité l'engouement. ^^

L'article expliquerait ce que tu viens de dire Eskimon puis détaillerait comme l'a fait Kje, en faisant référence aux sujets concernés de la Dev zone.

Vayel

En fait, un tuto "Comment contribuer au contenu du site ?" serait préférable. Et si l'on pouvait le garder de manière permanente sur l'accueil, encore mieux.

Arius

Suite à quelques visites dans les issues du dépôt Github, ça me semble nécessaire. Il y a des trucs en cours de partout, le code est imposant et le p'tit nouveau qui arrive là-dedans ignore où commencer, a peur de faire une bêtise, de coder quelque chose déjà prise en charge par une autre personne… Bien sûr, vous faites ce que vous voulez, mais je vous donne mon point de vue de l'extérieur. ^^

+0 -0

Un article ne pourrais donner que des infos général. Type "vous pouvez aider a tester la prochaine version sur la préprod", il ne saura pas forcément comment faire pour se lancer. Il faut je pense en soutient des sujets dédié sur le forum. Par exemple pour avoir les acces à la préprod, il suffit de le demander dans le sujet dédié. On pourrait peut être faire un sujet très général "acceuil des nouveaux dans l'equipe technique" ou les membres volontaires viendraient nous dire ce qu'ils veulent faire et où on pourrait les aiguiller sur ce chemin.

Pour le reste, oui c'est un gros projet. Je ne suis pas surs que les comparaisons dans l'article soient tres pertinentes (en particulier parce qu'on a un an alors que les deux autres sont bien plus vieux, ça explique la forte volatilité de notre nombre de lignes de codes). Mais c'est un beau projet et il est assez facile de rentrer dedans, il suffit de demander !

+0 -0

Mais c'est un beau projet et il est assez facile de rentrer dedans, il suffit de demander !

J'approuve !

Bon moi, je suis rentré au temps de la bêta, mais bon, ça reste la même chose. Puis, si il y a besoin d'aide pour quoi ce soit, un p'tit tour sur IRC et en général il y a toujours quelqu'un pour vous aider !

Après l'équipe technique en elle-même est assez cool, ils prennent le temps d'expliquer et d'aiguiller. Te disent comment faire telle ou telle chose. En soit, une chouette équipe !

Mais c'est un beau projet et il est assez facile de rentrer dedans, il suffit de demander !

Kje

Justement, où ? :P

Je n'ai malheureusement absolument pas le temps de m'impliquer sérieusement dans le code de ZdS, mais je me mets à la place d'autres. ^^

+0 -0
Connectez-vous pour pouvoir poster un message.
Connexion

Pas encore membre ?

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