Documentation

Toutes les documentations autour de PLaTon

PLaTon est une application complexe. Comme elle se veut ouverte au partage, idéalement PLaTon est documenté à tous les niveaux. Suivant le rôle que vous souhaitez jouer, vous devriez trouver une documentation adapté à vos intentions. Voici ici quelques conseils pour contribuer.

Pour les plus spécialistes de l’informatique souhaitant participer au coeur de l’application PLaTon, la documentation est porté par le code source dans le dépôt dédié permierlangage. L’architecture logicielle et le design applicatif est discuter plutôt ici plconception.

Les enseignants éditeurs travaillent sur l’éditeur en ligne de PLaTon. Pour cela, vous devrez être identifié sous une application utilisant le protocole L.T.I. (avec moodle par exemple). Une fois identifié sur une application de votre structure (université, lycée, …) avec L.T.I. en ayant le rôle d’enseignant, il suffit alors de suivre le lien suivant serveur Premier Langage

La documentation de PLaTon pour les enseignants est une compilation web du dépôt github suivant premierlangage-doc. Le rendu web est disponible publiquement sur cette page. Toute aide pour augmenter la qualité de la documentation (y compris des aides orthographiques) est bienvenue.

Librairie scientifique autour de PLaTon

PLaTon est une expérience de développement ambitieuse. Aussi, adopter une démarche rigoureuse est primordial pour assurer la pérennité du logiciel. Cette page rassemble des documents scientifiques et techniques autour de PLaTon.

Documents relatifs à la conception de l'outil PLaTon

  • La présentation suivante raconte un peu notre philosophie de développement. La présentation justifie nos choix organisationnel dans le développement de PLaTon.
  • Schéma du mécanisme de jeu des ressources dans PLaTon en Octobre 2018. Le schéma montre comment un exercice atomique est traité par le serveur pour être proposé à l'élève puis corrigé. Les actions sensibles (comme les exécutions de code proposé par des élèves) sont effectuées en machines virtuelles.
  • Schéma de l'architecture logicielle de PLaTon en Novembre 2018. Cette architecture à bien changer depuis mais le document illustre notre vision de l'application à la date précisée.
  • Schéma simplifié du jeu d'une ressource de PLaTon. Le Schéma situe les deux programmes python utilisés lors du jeu d'un exercice : le builder et le grader. Le premier prépare une ressource (en tirant au hasard une question par exemple). Le second programme a pour rôle de corriger et de conseiller l'élève suivant la réponse qu'il a fournit à l'exercice.

Articles pédagogiques et didactiques autour de PLaTon

Rien pour le moment, mais l’équipe de conception de PLaTon a clairement l’intention de faciliter toute personne ou équipe souhaitant utiliser PLaTon comme lieu d’expérimentation. Les besoins statistiques et logiques seront écouté pour permettre à tout enseignant et/ou chercheur de mener à bien son expérience.