Mise en place de tutoriels thématiques écriture d'exercices

[nborie]

Le but est d'encore de proposer des points d'entrée simples pour les débutants voire les débutants non informaticiens.

Actuellement le prix pour commencer est extrême. On a besoin d'un Dominique, d'un Quentin, d'un dev ou d'un power-user sous la main. Sachant que 90% de l'écriture d'exercice commencera par copier-coller, il serait de bon tons de proposer des tutoriels thématiques axés sur un besoin final :

• Premier exercice à un champ (form html avec 1 input et grader qui affiche le champ)
• Premier QCM (description de la première utilisation du template associé)
• Premier exercice de programmation en Python
• Premier exercice dans lequel on trace un graphe de fonction
• Premier exercice aléatoire (avec un build qui tire deux entiers au hasard et demande l'addition)
• ....

Outre les templates et leur finalité, ces tutoriaux expliquent surtout l'esprit des templates :

• quels sont les champs primordiaux ?
• quels sont les clés optionnelles ?
• comment utiliser de manière minimale/avancé les builder/grader ?
• quelles sont les parties customisable ?
• quels sont les comportements par défaut ?
• ...
  Il y a le produit fini mais il y a toujours de l'information non explicite connu de l'auteur et s'il prend le temps de le coucher par écrit, ça peut faire gagner beaucoup de temps.

Aussi, lorsqu'un template devient final (testé, robuste, clair et documenté), faut-il imposer de la documentation avant de faire un partage ? Je pose vraiment la question sachant que je n'aime pas écrire de la doc... Mais, en l'occurrence, pour le moment, c'est le zouk intersidéral pour tenter de trouver les infos. C'est ultra chiant l'imposition de la documentation mais on se dit systématiquement : "je ferai plus tard... " et finalement on fait jamais.