Le document computationnel

“ Un notebook est une interface de programmation et d'interprétation ou exécution du code qui permet de combiner langage naturel, langage informatique et rendu computationnel (tableaux graphiques, etc.) ”. (Extrait de la ressource “ Notebook ” de DoRANum).

Contexte d'apparition du notebook

Le document computationnel ou notebook est né du besoin d'assurer l'intelligibilité et la reproductibilité de la recherche dans le contexte des avancées technologiques des années 1970. Des chercheurs comme Jon F. Clearbout vont alors développer des interfaces de programmation visant à assembler du texte mis en forme et du code exécutable, avec pour objectif de rendre les scripts plus compréhensibles et de permettre la reproductibilité des analyses exposées.  

De plus en plus plébiscité dans le cadre de la recherche scientifique, le document computationnel permet en pratique de documenter sa démarche scientifique en : 

• Apportant des explications sur les données avec du texte codé en markdown.
• Répondant à la question posée avec du code informatique exécutable.
• Présentant le résultat de ce code sous forme de tableau, graphique, résultat de calculs, visualisation de données...

Initiatives communautaires

Conscientes des difficultés du coût d'entrée technique et méthodologique de la pratique du notebook, des initiatives communautaires ont vu le jour, comme par exemple les revues scientifiques Computo et Rzine ou les groupes de travail GT Notebook et Notebooks Now !. Elles produisent des ressources méthodologiques afin de promouvoir l'utilisation du document computationnel auprès de la communauté scientifique . DoRANum a également publié sur son site une ressource consacrée au Notebook, dont les objectifs sont les suivants :

• Comprendre le fonctionnement d’un notebook ;
• Comprendre l’intérêt de cet outil pour la reproductibilité de la recherche ;
• Citer plusieurs systèmes de notebooks ;
• Comprendre l’articulation possible et puissante entre les notebooks et les forges logicielles.