Liste des ateliers Blog Contribuer
Revenir à la page d'accueil

Comment contribuer

Guide général de contribution

Cette page étant un véritable temple de modernité, il s'agit d'une page hébergée sur Github. Il suffit donc de soumettre un patch pour créer une modification. Il n'y a aucun générateur. La contribution peut prendre deux formes:
  1. Ajouter un exercice
  2. Ajouter une solution

Attention, dès lors qu'une contribution est validée, elle est considérée comme libre (sauf si une note explicite, altère la licence du contenu).

Ajouter un exercice

L'ajout d'un exercice s'effectue en deux étapes. La première consiste à lui créer une page, en se servant du template et de l'enregistrer dans le répertoire topics, ensuite il suffit de modifier la liste pour ajouter votre exercice dans la liste (en tâchant de l'ordonner correctement pour préserver une certaine logique dans la suite d'exercices).
Il est conseillé de fournir une première solution pour évincer les potentielles premières ambiguïtés, donc il n'est pas nécéssaire de proposer une solution absolument overkill et l'usage d'un langage mainstream est conseillé.
Essayez de rédiger des exercices claires idéalement dans un HTML5 valide.

Ajouter une solution

L'ajout d'une solution pour un exercice consiste simplement à modifier la page de l'exercice pour ajouter sa propre solution. En s'inspirant de celle des autres. Une solution est représentée par un lien vers une page de votre choix (un répertoire Git par exemple) avec, idéalement, une explication de comment lancer votre solution et peut être un bilan de l'implémentation.
Bien que le courriel soit facultatif, il est tout de même conseillé de le mettre, pour permettre aux éventuels lecteurs d'effectuer un retour sur votre proposition.

Les contributions sont statiques, on compte donc sur la maturité de chacun pour ne pas saccager le travail des autres.

Commenter

Chaque page d'exercice propose un espace de conversation (fourni par disqus.com). Une forme naïve de contribution est de poser des questions ou de répondre à ces questions dans les espaces proposés à cet effet !