Licence CC BY

Zeste de Savoir participe au Hacktoberfest 2021

Ce mois-ci est l'occasion idéale pour faire vos premières contributions au projet technique !

Comme tous les ans depuis quelques années, l’hébergeur Digital Ocean organise la Hacktoberfest ! Derrière cette référence à la fameuse fête de la bière munichoise se cache un événement célébrant l'open source et encourageant à contribuer à vos logiciels open source favoris.

Cette année encore, le projet technique de Zeste de Savoir, le logiciel qui fait tourner le site que vous êtes en train de lire, participe à l’événement ! Ce billet vous donne les informations essentielles si vous êtes motivés pour contribuer au code de Zeste de Savoir dans le cadre de la Hacktoberfest, voire au-delà. ;)

Bannière Hacktoberfest.
Bannière Hacktoberfest (source).

Le projet technique de Zeste de Savoir

Le projet technique de Zeste de Savoir désigne tout ce qui fait tourner le site que vous êtes en train de visiter en ce moment-même. Le cœur du projet est hébergé sur GitHub sur le dépôt zds-site et contient principalement :

  • le backend en Python avec l’utilisation du framework Django ;
  • le frontend en Javascript et SCSS ;
  • la documentation du projet.

Deux autres outils complètent zds-site :

  • zmarkdown, qui permet de faire le rendu de tout ce qui est écrit en Markdown sur le site ;
  • latex-template, qui sert pour l’export PDF de nos publications.

Que vous soyez plutôt Python, Javascript, CSS, ou un adepte de LaTeX, vous trouverez sûrement des choses à votre goût pour contribuer !

Contribuer au projet

Se préparer

La première étape si vous souhaitez contribuer est de s’inscrire sur GitHub si ce n’est pas déjà le cas. Le code de Zeste de Savoir y est hébergé. Pour contribuer efficacement, un compte est indispensable.

La seconde étape consiste à installer l’environnement de développement. Autrement dit à installer le site sur votre ordinateur. La documentation du site fournit des guides pour débuter pas-à-pas ainsi qu’une page consacrée à l’installation avec le détails des instructions nécessaires installer l’environnement.

Contactez-nous !

L’installation peut présenter quelques difficultés en fonction des spécificités de votre système. En cas de soucis, n’hésitez pas à nous contacter ! Les contributeurs réguliers de Zeste de Savoir sont disponibles sur le canal #développement-de-zds du serveur Discord non-officiel de la communauté ou le forum Dev Zone.

Trouver votre premier ticket à résoudre

Si vous êtes un nouveau contributeur, les tickets marqués « Facile » sont faits pour vous ! Nous avons concocté une liste de tickets « Facile » restant à résoudre.

Nos tickets « Facile » sont conçus spécifiquement pour vous mettre le pied à l’étrier sur le projet. Ils sont volontairement fournis avec une solution identifiée, ou un début de solution et demandent peu de familiarité avec les entrailles du projet. Idéal pour découvrir le processus de contribution !

Résoudre le ticket et soumettre votre contribution

La résolution du ticket est à votre initiative et dépend du ticket, il n’y a donc pas d’instructions particulières, si ce n’est que tout ce qui touche au Python doit être accompagné de tests unitaires. Dites-nous si vous rencontrez des difficultés, on sera là pour vous aider !

Le projet intègre les mises à jour à travers des pull requests (demande de fusion en français). Une fois que vous êtes satisfaits de votre travail, ou que vous avez envie de recevoir des commentaires sur votre travail en cours, vous pouvez créer une pull request sur le dépôt.

Un membre de l’équipe technique s’assurera de la qualité de celle-ci et vous dira ce qu’il faut modifier si nécessaire. Une fois que tout est bon, elle sera fusionnée au projet !

Merci de prendre connaissance du Code de Conduite de Contributeurs et de le respecter pour garder ce projet ouvert et accueillant !


Miniature du billet : logo Hacktoberfest 2021, utilisation selon les conditions de Digital Ocean.

2 commentaires

J’ai atteint mon objectif de 5 PR pour ZdS pour cet Hacktoberfest ! Je me suis focalisé sur du remboursement de dette technique (tests manquants, fichiers obsolètes), ce qui est aussi préparatoire pour de nouvelles fonctionnalités (à commencer par le journal des événements qui traîne depuis trop longtemps).

On est à mis parcours, il reste plein de temps si vous souhaitez mettre un pied dans le développement de ZdS. L’idéal (pour les contributeurs débutants en particulier) étant toujours les tickets faciles, qui permettent de résoudre un soucis tout en découvrant paisiblement le fonctionnement du projet.

+2 -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