Vos commentaires sont les bienvenus

Vous avez essayé d’utiliser des lignes de code qui ne fonctionnent pas ?

Vous avez besoin d’explications plus claires pour comprendre une commande informatique ou un concept ?

Vous avez trouvé une coquille ou vous avez repéré une erreur de syntaxe ?

Merci de prendre le temps de signaler ce problème ou de proposer un changement. Votre aide est cruciale pour nous aider à continuer de proposer les meilleures leçons possibles !

Option 1 : Envoyez-nous un mail ou un tweet

Contactez Jessica Parr au Simmons College ou l’un des autres membres de notre équipe projet. Vous pouvez aussi envoyer un tweet @ProgHist.

Option 2 : Ouvrez une “issue” sur GitHub

C’est le mode de contact que nous privilégions pour gérer les commentaires, parce qu’il permet à tous les rédacteurs et toutes les rédactrices de prendre connaissance de votre “issue” et d’y répondre.

D’abord, si vous n’en avez pas déjà un, créez un compte gratuit et personnel sur GitHub Ou connectez-vous directement à votre compte si vous en avez déjà un.

Ensuite, rendez-vous sur la page rassemblant les issues pour notre dépôt Github.

Jetez un coup d’oeil aux “issues” pour voir si le problème que vous avez identifié n’a pas déjà été signalé. Si c’est le cas, mais que vous souhaitez partager des informations complémentaires, laissez un commentaire sur cette “issue”.

Si votre “issue” n’a pas été signalé, créez une nouvelle “issue” en utilisant un titre clair, et fournissez le plus d”informations possibles sur le problème que vous avez identifié.

Pour plus d’informations sur les “issues” GitHub, vous pouvez lire le guide GitHub Mastering Issues.

Option 3 : Proposez un changement en particulier

Pour suggérer ou faire des changements mineurs dans une leçon, rendez-vous d’abord dans le répertoire des leçons et cliquez sur la leçon concernée.

Ensuite, faîtes apparaître l’historique de la leçon en cliquant sur le bouton “History” :

Maintenant cliquez sur le commit le plus récent pour la leçon :

Ensuite, pour ajouter un commentaire sur une ligne, passez la souris sur le numéro de la ligne et un signe plus (+) de couleur bleue va apparaître ; en cliquant sur celui-ci, vous allez ouvrir une boîte de commentaire pour cette ligne en particulier. La ligne qui a besoin d’être corrigée peut être cachée ; dans ce cas, cliquez sur l’icône “développer”, de façon à faire apparaître les lignes cachées.

Les rédacteur(trice)s recevront les notifications concernant ces commentaires et pourront ensuite inclure vos suggestions dans les leçons. Bien que nous favorisions autant que possible l’ouverture du Programming Historian en français, seul(e)s les rédacteur(trice)s peuvent, pour le moment, effectuer directement des changements dans les leçons.

Option 4 : Faire une pull request

Si vous pensez que vous savez comment corriger un problème dans une leçon, vous pouvez envisagez de réaliser un “fork” de notre dépôt GitHub et de faire une “pull request”.

Pour plus d’informations sur les pull requests, consultez le guide Github Forking Projects ou le tutoriel de Rich Jones How to GitHub.

Ressources complémentaires sur Git et GitHub

Utiliser Git et Github peut devenir relativement simple une fois que vous avez un peu de pratique. Si vous souhaitez en apprendre plus et contribuer, le site internet de GitHub est un excellent endroit pour débuter.