Mise en place d'un index des clés PL

[nborie]

L'objectif est de mettre en place une page de documentation semblable par exemple à la page de doc de la libMLV listant toute les fonctions définies dans la libMLV...

Ici, l'objectif est de proposer un index des clés répertorié existante

Clé PL générale

• title (obligatoire) : définira un titre pour votre exercice
• author (optionnel) : renseigne sur l'auteur de l'exercice
• ....

Template stdsandboxC.pl

Ce template va voir fournir gratuitement les clés suivantes : form (éditeur avec coloration C++), ...

• codebefore (optionnel) : pour spécifier du code contextuel à inclure avant le code soumis par l'étudiant et cela avant de procéder à la compilation.
• solution (optionnel) :
• tests (obligatoire) : description des tests (nom, argument, entrée standard (et sortie standard attendue optionnel)) qui seront mis en oeuvre par le gradeur.
• ....

Template parametrized_MCQ.pl

• data_from_file (obligatoire) : un lien vers le fichier de questions de type AMC-TXT
• ....
  C'est une page qui devrait être mis à jour par les enseignants éditeur de template ou de fonctionnalité générique pour favoriser la réutilisation.

---

Outre le fait de proposer des points d'entrées supplémentaires dans la documentation des features, encore une fois, les débutants PL posent très souvent les questions : quels clés il faut absolument que je définisse ? Pourquoi ? À quoi elles servent ? et aussi, où puis-je trouver cette information ?

[qcoumes]

Les clés relatives aux templates devraient être indiqué sur la documentation de la template, comme pour le Java par exemple.