Ce projet est un livre de recettes sur l'intégration web et ce qui gravite autour (accessibilité, bonnes pratiques HTML/CSS ...).
Il est porté par la tribu (groupe de pratiques) W4LL de OCTO Technology.
Nous avons choisi de le concevoir à l'aide de Eleventy | 11ty (un générateur de site statique).
Les articles sont au format Markdown qui présente l'avantage de se convertir facilement en HTML.
Les contributions (internes OCTO Technology) sont les bienvenues :)
Si c'est ta première contribution n'hésite pas à jeter un coup d'oeil au fichier CONTRIBUTING.md à la racine du projet.
Tu trouveras un template d'article au format MD dans le dossier cookbook. C'est le fichier _template.md.
Duplique-le, rédige ta recette et ouvre une PR.
Ta branche doit s'appeler feat/recette-nom_de_ma_recette
Les commits sont squashés donc pas de contraintes de ce côté-là.
Le markdown est un format standardisé pour la rédaction de contenu.
Tu es développeur ? Ton IDE préféré supporte probablement nativement ce format. Si ça n'est pas le cas, une recherche rapide dans les plugins doit pouvoir t'aider.
Tu n'es pas développeur ou tu souhaites utiliser un outil différent ? Tu peux utiliser un outil en ligne, par exemple StackEdit qui est en plus installable.