Fiches de Travaux Pratiques
Ce répertoire contient un ensemble de fiches pédagogiques destinées à l'enseignement du HTML, du CSS, le JavaScript (et pourquoi pas plus).
Contribuer une nouvelle fiche
Pour commencer une nouvelle fiche, vous devez passer par GitHub. Si vous êtes novice, une petite lecture peut vous aider. Voici les étapes à suivre :
- réaliser un fork de ce dépôt sur votre compte GitHub ;
- cloner ce dépôt en local sur votre poste :
https://github.com/{votre pseudo}/fiches.git
- Au sein de votre dépôt GitHub local, travailler dans la branche
master - Soit via votre gestionnaire graphique
- Soit en ligne de commande :
git checkout master- au sein du dossier
_posts, ajoutez votre nouvelle fiche. Vous pouvez éventuellement copier/coller une fiche existante pour avoir un modèle. Deux formats sont possibles : HTML ou Markdown.
Une fois votre fiche écrite, vous pouvez la contribuer en faisant une Pull Request. L'équipe de TrainDrop s'occupera de l'intégrer au bon endroit. N'oubliez pas de bien renseigner le titre de votre fiche et les metadonnées "Principes abordés" et "Niveau requis", c'est ce qui servira aux lecteurs à la retrouver dans l'index.
Evidemment, si vous avez des idées pour améliorer ce processus de contribution, n'hésitez pas à nous en faire part dans le ticket dédié.
Bonnes pratiques de mise en forme
Pour aider les développeurs et contributeurs à définir et maintenir des styles de codage cohérents en dépit de leurs différents éditeurs de texte ou IDE, TrainDrop utilise EditorConfig. Le fichier de configuration, situé à la racine du projet, définit quelques règles qui seront automatiquement appliquées par votre outil si vous l'équipez du plugin adapté.
Des plugins existent pour pour de nombreux outils, n'hésitez pas à télécharger et installer celui ou ceux qu'il vous faut.