From 5393a14f155095930780e20f6225163b2076420b Mon Sep 17 00:00:00 2001
From: arthur baudet <arthur.baudet@lcis.grenoble-inp.fr>
Date: Wed, 13 May 2020 13:16:52 +0200
Subject: [PATCH] =?UTF-8?q?module=202=20(=C3=A0=20refaire=20avec=20emacs)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 journal/module_2/document_computationnel.md   | 54 +++++++++++++++++++
 journal/module_2/prise_en_main.md             | 12 +++++
 .../module_2/travailler_avec_les_autres.md    |  5 ++
 journal/module_2/tuto.org                     | 17 ++++++
 4 files changed, 88 insertions(+)
 create mode 100644 journal/module_2/document_computationnel.md
 create mode 100644 journal/module_2/prise_en_main.md
 create mode 100644 journal/module_2/travailler_avec_les_autres.md
 create mode 100644 journal/module_2/tuto.org

diff --git a/journal/module_2/document_computationnel.md b/journal/module_2/document_computationnel.md
new file mode 100644
index 0000000..957c013
--- /dev/null
+++ b/journal/module_2/document_computationnel.md
@@ -0,0 +1,54 @@
+# La vitrine et l'envers du décor : le document computationnel
+
+Choix de l'outil : **Jupyter** (et Emacs/Org mode)
+
+
+## Difficultés rencontrées lors d'une tentative de reproduction
+
+- Manque d'informations (sources et données)
+- Non explication des choix (protocoles expérimentaux, données conservées/conservées, méthodologie
+  statistique, ...)
+- Erreurs induites par les ordinateurs
+    - outils à interface graphique pouvant cachant le fonctionnement interne
+    - tableurs
+    - outils complexes (boites noires) mal maîtrisés
+    - bogue dans les programmes "maison"
+- Manque de rigueur et d'organisation
+    - non sauvegarde des données
+    - pas de gestion de version (historique)
+    - pas de manque de contrôle qualité
+- Dimension culturelle et sociale
+    - un article n'est qu'une version simplifiée
+
+## Idées reçues sur le "tout public"
+
+- Les faiblesses deviendront évidentes
+    - ne pas pouvoir tricher ne devrait pas être un argument
+- Quelqu'un peut trouver une erreur
+    - tout le monde en fait
+    - la correction des résultats est plus importante
+    - tirer avantage à ma place (tirer avantage = des citations, montrer ce qu'on fait c'est se
+      rendre visible)
+    - les données sensibles n'ont pas besoin d'être partagées à "tout le monde" et/ou de façon
+      "claire"
+
+## Outils, formats, services
+
+**Préférer le libre / open source**
+
+- formats de fichiers : markdown, orgmode, CVS, HDF5, ... (rester simple)
+- langage/outils de programmation : scilab, R, Python, ...
+- plateforme de stockage : gitlab/github, framadrop, ...
+- ne pas tomber dans le piège des outils *trop* intuitifs (tableurs, interfaces
+  graphiques/interactives, ...)
+
+
+## Principes
+- Permettre une transparence la plus complète possible
+- Une publication est la partie visible de l'iceberg.
+- Avoir un seul document (explications, code, résultats)
+- Inspection et ré-execution
+
+
+<!-- vim: spelllang=fr
+-->
diff --git a/journal/module_2/prise_en_main.md b/journal/module_2/prise_en_main.md
new file mode 100644
index 0000000..c5f1391
--- /dev/null
+++ b/journal/module_2/prise_en_main.md
@@ -0,0 +1,12 @@
+# Prise en main de Jupyter et OrgMode
+
+## Jupyter
+
+- Passer en markdown            -> m
+- Passer en code                -> y
+- Executer                      -> CTRL-Enter
+- Executer et passer à la suite -> ALT-Enter
+
+
+## OrgMode
+Voir `tuto.org`
diff --git a/journal/module_2/travailler_avec_les_autres.md b/journal/module_2/travailler_avec_les_autres.md
new file mode 100644
index 0000000..37fd90c
--- /dev/null
+++ b/journal/module_2/travailler_avec_les_autres.md
@@ -0,0 +1,5 @@
+# Travailler avec les autres
+
+
+<!-- vim: spelllang=fr
+-->
diff --git a/journal/module_2/tuto.org b/journal/module_2/tuto.org
new file mode 100644
index 0000000..e94c9f5
--- /dev/null
+++ b/journal/module_2/tuto.org
@@ -0,0 +1,17 @@
+#+TITLE Prise en main de OrgMode
+
+* Exécution de code
+  #+begin_src python :result output :export both
+  print("a")
+  #+end_src
+
+L'ajout de snippet automatique ne fonctionne pas.
+
+L'exécution ne fonctionne pas : "org-babel-execute-src-block: No org-babel-execute function for python!".
+
+#+begin_src shell :sesson *shell* :result output :export both
+ls /tmp/
+#+end_src
+
+Ne fonctionne pas "out of the box". Mais relativement intéressant pour faire de la prise de note.
+À pousser.
-- 
2.18.1