Salut les agrumes,
Ça fait longtemps que je réfléchis aux actions pour rendre la contribution à Zeste de Savoir plus simple et je pense qu’un des points qui manque aux nouveaux arrivants c’est une vue globale sur le projet. Le projet est gros avec beaucoup de dépendances, beaucoup de fichiers… bref, on s’y perd facilement !
L’idéal serait d’améliorer la documentation pour qu’elle puisse être le point d’entrée du projet et guider le contributeur dans ses premiers pas, en plus de son rôle de documentation. On pourrait aussi améliorer le guide du contributeur qui est disponible dans la bibliothèque, mais je pense qu’il est plus simple pour l’équipe technique que ce soit dans la documentation.
Mais voilà, j’ai tenté plusieurs fois de retravailler la documentation mais je ne suis jamais allé jusqu’au bout, mon perfectionnisme me rattrapant avant d’avoir écrit une page. J’aimerais donc tenter un autre format, celui de la vidéo. Vous pensez sûrement que c’est paradoxal, les vidéos travaillées demandant beaucoup de travail, peut-être plus que du texte. Pour réduire le travail que ça demande, je ne vais pas faire de vidéo visuelle avec des animations mais simplement un enregistrement de mon écran où j’expliquerai des choses en allant sur Github, sur la documentation, etc.
Vient une question, dois-je faire la vidéo chez moi et la publier ensuite ? Ou alors, dois-je faire un live dont l’enregistrement servira de vidéo ? Je pense que pour la motivation et la lutte contre le perfectionnisme, un live serait mieux. Néanmoins ça nécessite des spectateurs, sans quoi ça ne sert pas à grand chose. Si jamais je fais la vidéo chez moi, je vais probablement la découper en plusieurs morceaux pour rendre la tâche plus aisée.
Dites moi si un live vous intéresse ! Si jamais vous avez des questions sur le projet technique n’hésitez pas à les poser, j’essaierai d’y répondre dans la vidéo.
Situphen
