# FORMATION PRO : Documenter des projets pour contribuer aux communs 2024 # [Questionnaire de fin de formation](https://cloud.seatable.io/dtable/forms/fa82f329-2ab4-41d4-b530-336bad4a57ed/) ::: info Ce pad est écrit en [**syntaxe Markdown**](https://www.arthurperret.fr/tutomd/). Il est accessible à toute personne ayant connaissance de l'URL. :::  # JOUR 1 ## 9h - Accueil, tour de table ☕️ - Présentation de la formation et de son cadre - Tour de table : présentation des stagiaires, du formateur et de l'association PiNG. - Tour de table : présentation des stagiaires et des attentes de chacun⋅e concernant la formation. ## 09h30 - Brise glace - Petit états des lieux des pratiques de documentation ❄️ :::info L'atelier commence avec l'ensemble des participant⋅es debouts. Des questions sont posées, à chaque fois qu'ils et elles répondent positivement, les participant⋅es s'assoient. ::: - Avez-vous déjà contribué sur un wiki ? - Avez-vous déjà écrit un carnet de bord ? - Avez-vous déjà écrit un tutoriel ? - Avez-vous déjà réalisé un compte-rendu de réunion ? - Avez-vous déjà réalisé un fanzine ? - Avez-vous déjà partagé une recette de cuisine à un⋅e ami⋅e ? - Avez-vous déjà pris une photo souvenir ? - Avez-vous tenu un "journal intime" ? - Avez-vous déjà enregistré du son (musique, conférence, etc), pour vous en souvenir ? ... ## 09h50 - Timeline - Retour historique sur les pratiques documentaires, de la bibliothèque d’Alexandrie aux communs de la connaissance 🌐 :::info À la manière du jeu de société Timeline, chaque stagiaire tente de placer des cartes au tableau, dans un ordre chronologique. Une fois les cartes mises en ordre chaque stagiaire choisit une carte dont le nom l'intrigue pour effectuer quelques recherches dessus et la présenter aux autres. ::: :::danger [Liste des cartes](https://hackmd.io/@hindelstark/ry21DuH35) *(ne pas consulter avant la fin de l'atelier)* ::: ## 10h45 Pause ## 11h00 Des communs aux cultures libres [Lien vers la présentation (.pdf)](https://station.pingbase.net/index.php/s/wTDa5sypAWs2tMr) ## 11h30 Introduction à l’écriture collaborative et à la syntaxe markdown 👨‍💻 [Lien de la présentation](https://hackmd.io/@hindelstark/HyK8cZLFF#/) ## 11h45 Exercice pratique En autonomie, chaque stagiaire suit le tutoriel d'apprentissage interactif du Markdown proposé par le collectif CommonMark et traduit par [Arthur Perret](https://www.arthurperret.fr). [>>TUTORIEL<<](https://www.arthurperret.fr/tutomd/) **Mémo :**  ## 12h30 - Pause repas 🥗🍴 ## 13h30 Mise en situation d'écriture collaborative ⌨️ <iframe width="100%" height="315" src="https://www.youtube.com/embed/3pJFKAZjRCM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> :::info Mise en situation de prise de note collaborative de la vidéo « La documentation » de [Monsieur Bidouille](https://www.youtube.com/c/monsieurbidouille). La consigne est d'effectuer en collaboration une prise de notes de la vidéo, dans ce pad, au format markdown. Les stagiaires peuvent prendre quelques minutes pour s'organiser comme ils et elles le souhaitent. ::: //// LA PRISE DE NOTE DU GROUPE 1 COMMENCE CI-DESSOUS : //// # Caractère viral du savoir Partage savoir sur Internet : savoir accesible _ échanges infos et enrichissements collaboratifs # La documentation Mvt Maker : expansif avec partage de fichiers mais aussi de la phase créative du fichier. Documentation du chemin parcouru et des voies alternatives possibles Ex. Imprimantes 3D : amélioration des dispositifs grâce au partage des retours d'expérimentation. Documentation internet : apparition et développement d'amateurs qui s'intéressent à des domaines qui leur étaient inconnus avant Formes alternatives de créativité : Oui are maker ; wikifab Innovation : fruit d'un savoir collectif, et non d'un "génie" unique # Aspect communautaire de l'Open Science Communauté rend info dispo Mouvement macker facteur : **la documentation** **partage de la phase créative** reprise de la base # Des nouvelles voies de créativité chemin parcouru avec l'ouverture de chemin alternatif décloisonnement *les gens développant des solutions locales à des problèmes locaux* pratique alternative => avec ses propres enjeux et propres techniques # conclusion L'Innovation est issu d'apports collaboratifs, c'est > le fruit d'un travail collectif > Des exemples de ressources collaboratives : + wikipedia [lien](https://fr.wikipedia.org/wiki/Wikip%C3%A9dia:Accueil_principal) + we are maker *(français)* + wikilab --- -*-- //// LA PRISE DE NOTE DU GROUPE 2 COMMENCE CI-DESSOUS : //// ## Notes exemple de la Série BD lANFEUST dès qu'un savoir devient accessible -> les gens s'en emparent et ajoutent de l'information à leur tour # Mouvement Maker le mouvement maker prend de l'ampleur plusieurs facteurs dont **la documentation** ## Comment partager l'information? 1) Metter le fichier sur un plateforme, le partager 2) parter le fichier d'edition (partition dans le cas de la musique, ou le code dans le cas des logiciels) ex la musique : je prend un fichier que je met sur internet mais je ne documente pas, je partage mon travail le coeur de la documentation serait plus la partition de la musique que le fichier mp3. je peux alors faciliter la tache aux autres partitiens docuemnter montree le. chemin parcouru mais aussi pour les autres de prendre d'autres chemins ### Makers pour un maker la documentation est donc le partage sous forme numérique la création d'un objet. exemple des imprimantes 3D ou les amateurs ont documentés leurs expérimentations et que les makers ont pu utiliser. > Internet a fait apparaitre l'amateur et parmis ces amateurs, des citoyens "éclairés". ### Outils pour fabriquer des "trucs" : [fusion 360](https://www.autodesk.com/products/fusion-360/overview?term=1-YEAR&tab=subscription&plc=FSN) [autodesk](https://www.autodesk.com) ### Partage de ces trucs : Thingiverse *(MakerBot)* https://ouiaremakers.com/ ### Qui est Monsieur Bidouille?  --- --- ### Échanges : retours d'expérience Comment avez-vous réalisés l'exercice ? Qu'est-ce qui a bien fonctionné ? Qu'est-ce qui n'a pas fonctionné ? Quels enseignements en tirer ? ## 13h50 - La documentation au quotidien et dans son cadre professionnel: pour qui, pourquoi, quand et comment ? 🗣 [Lien vers la présentation (.pdf)](https://station.pingbase.net/index.php/s/BNYDkcPgL65QsNR) ## 14h20 - Quel cahier des charges pour ma documentation ? 📝 Chaque participant⋅e écrit le cahier des charges de sa documentation sur la trame proposée. Ensuite à tour de rôles chacun⋅e affiche et présente son travail. [Lien vers la trame écrite (.pdf)](https://station.pingbase.net/index.php/s/waRz2zTnGjwxd6L) Lien vers le fichier .odt : https://station.pingbase.net/index.php/s/3PDQPXnJKmGgLYN ## 14h50 PAUSE ## 15h05 - Présentation de documentations inspirantes <iframe width="100%" height="315" src="https://www.youtube.com/embed/SCGeuM4de7M?si=q9vILO2Re2cDYelt" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> <iframe width="100%" height="315" src="https://www.youtube.com/embed/H0WSfr4_0XU?si=9_ac2VApWtrOhWCI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> <iframe width="100%" height="315" src="https://www.youtube.com/embed/esNfg_XbXMY?si=aa4MPKRRZvTQF1rU" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> <iframe width="100%" height="145" frameborder="0" scrolling="no" style="width: 100%; height: 145px; overflow: hidden;" src="https://podcast.pingbase.net/@ainsifont/episodes/gueules-de-bois/embed"></iframe> Mais aussi : - Faire ensemble : les ["contribateliers"](https://contribateliers.org/trouver-un-contribatelier/les-contribateliers-nantais/) - [Hyphes.net](https://hyphes.net/index.php/Accueil) d'Anne Archet, un [Wikipédia narratif](https://carnet.fabriquedunumerique.org/hyphes-danne-archet-un-wikipedia-narratif/) et une oeuvre hypertextuelle - [Ubuweb](https://www.ubu.com/resources/index_fr.html), est un site web anglophone non-commercial fondé en novembre 1996 par le poète et critique musical Kenneth Goldsmith qui recense de nombreux fichiers (sons, vidéo) d'avant gardes ## 16h00 Tour de table et retours sur la journée - pépites et cailloux - évaluation # JOUR 2 ## 9h00 - Tour de table rapide - Depuis hier, quelles nouvelles attentes ? Est-ce qu'il faut revenir sur des éléments évoqués pendant le premier jour ? Questions-réponses : [Lien pour choisir la licence adaptée](https://chooser-beta.creativecommons.org/?lang=fr) [Lien vers la licence amicale](http://amicale.li/) ## 9h15 - Panorama d'outils de documentation collaborative 🖼 :::warning Préambule : [L'outil collaboratif n'existe pas](https://interpole.xyz/?LOutilCollaboratifNExistePas2). L'outil n'est qu'un outil. *"L'outil ne collabore pas, c'est un groupe humain qui décide de collaborer, qui apprend à le faire et qui finalement choisit ses en outils. Seulement alors, les outils deviennent collaboratifs, mais ne le sont jamais par essence."* ::: ### Récolter du texte et de l'image en temps réel et à plusieurs :::success **Outil 1 : Des "pads" utilisant la syntaxe Markdown** - Exemple, la documentation du [Mouvement SER](https://pad.lescommuns.org/doc_JESER2022?view) [**Hedgedoc**](https://hedgedoc.org/) est un éditeur de texte au format Markdown, open source, et collaboratif. C'est avec cet outil qu'a été conçue la page que vous êtes en train de lire. Cet outil doit cependant être hébergé sur un serveur. Une plateforme équivalente du nom de [**HackMD**](https://hackmd.io/#) permet de créer des pads similaires simplement en s'y inscrivant. ::: ### Capitaliser des informations avec un wiki collaboratif :::success **Outil 2 : [Mediawiki](https://fr.wikipedia.org/wiki/MediaWiki)** - Exemple : [wikipédia.org](https://fr.wikipedia.org/), [wikifab.org](https://wikifab.org/), ou [movilab.org](movilab.org/) Mediawiki est un logiciel libre et open source très important en ce qui concerne l'histoire d'Internet et des communs numériques. En effet Mediawiki est le moteur de wiki conçu par la [Wikimedia Foundation](https://fr.wikipedia.org/wiki/Wikimedia_Foundation) pour répondre aux besoins de l'encyclopédie universelle [Wikipédia](https://fr.wikipedia.org/). À PiNG, nous l'utilisons pour faire fonctionner notre wiki de documentation technique, [Fablabo.net](https://fablabo.net/wiki/Accueil). C'est pour nous une manière de faire de la médiation autour des enjeux de l'ouverture des savoirs et des communs numériques. À l'origine éditer les pages se faisait à l'aide de la [syntaxe médiawiki](https://www.mediawiki.org/wiki/Help:Formatting/fr), désormais, de nombreux wiki utilisent des éditeurs visuels (comme la barre d'outils LibreOffice) ::: :::success **Outil 3 : [YesWiki](https://yeswiki.net/)** - Exemple [le wiki de la formation](https://ferme.yeswiki.net/documentation-ping/) ou [cerealeslocales.org](https://www.cerealocales.org/?PagePrincipale) ou [fleurslocales.eu](https://participa.fleurslocales.eu/?Articles) YesWiki est un logiciel libre à destination notamment d'animateurs de projets coopératifs, ce logiciel est plus facile d'accès que mediawiki, notamment pour les contributeur⋅ices : il est possible d'y éditer une page en un "double-clic". Porté originellement par Outils-Réseaux, il est désormais développé par l'association YesWiki. Pour commencer, vous pouvez [créer un test sur la ferme YesWiki](https://yeswiki.net/?PageCreer) *Attention ce site est géré par des bénévoles, il n'est pas maintenu et vos tests seront détruits périodiquement.* ::: :::info **Pour aller plus loin :** Il existe désormais quantité de moteurs de wiki, [une liste pléthorique de logiciels de wiki est disponible sur Wikipedia](https://fr.wikipedia.org/wiki/Liste_de_logiciels_wiki). ::: ### Publier un livre de documentation numérique :::success **Outil 4 : [Bookstack](https://www.bookstackapp.com/)** - Exemple : [cracn.fr](https://cracn.fr/) Bookstack est un logiciel libre qui permet d'écrire de la documentation sous forme de livres numériques, à l'aide de la syntaxe Markdown. Il doit être auto-hébergé sur un serveur mais [il est accessible ici en version démo](https://demo.bookstackapp.com ). Si vous ne souhaitez pas vous auto-héberger, une alternative (non libre) existe, [**GitBook**](https://www.gitbook.com/). ::: :::success **Outil 5 : [Do⋅doc](https://dodoc.fr/)** - Exemple : [Récits solidaires](https://www.makery.info/2020/05/30/covid-initiatives-solidaires-pour-faire-et-latelier-des-chercheurs-mettent-en-recit-la-mobilisation-maker/) Conçu par [l'Atelier des chercheurs](https://latelier-des-chercheurs.fr/) pour documenter et créer des récits à partir d'activités pratiques, do•doc (prononcer doudoc) est un outil libre et modulaire, qui permet de capturer des médias (photos, vidéos, sons et stop-motion), de les éditer, de les mettre en page et de les publier. Son design composite permet de le reconfigurer de manière à ce qu'il soit le plus adapté possible à la situation dans laquelle il est déployé. Il est possible d'utiliser ce logiciel pour créer de véritables stations de documentation mobiles comme celle d'[Antoine Taillandier](https://fablabo.net/wiki/Instacliip) ou celle du [collectif Praticable](https://praticable.fr/productions/mobilier-do-doc) :::  ### Le cas du Personnal Knowledge Management *"La gestion des connaissances personnelles (Personal knowledge management ou PKM) est l'ensemble des procédés qu'un individu met en œuvre pour rassembler, rechercher, classifier et partager la connaissance au quotidien, ainsi que la manière dont ces processus aident son travail. Ce concept est associé à l'idée selon laquelle le travailleur de la connaissance doit être acteur de son propre apprentissage. Enfin il s'agit d'une approche bottom-up de la gestion des connaissances, qui s'oppose à une pratique traditionnelle plus top-down"* - [Wikipedia](https://fr.wikipedia.org/wiki/Gestion_des_connaissances_personnelles) Une grande partie des méthodes et des logiciels existants dans ce domaine sont inspirés par la méthode "Zettelkasten", un terme allemand signifiant "« "boîte de notes", également traduit par "boîte à idées", et utilisé pour décrire une méthode de gestion des connaissances et de prise de notes. Cette méthode était notamment employée par le sociologue Niklas Luhmann. Pour aller plus loin sur le sujet, voir l'article d'Arthur Perret : [Et toi, qu'est-ce que tu fiches ?](https://www.arthurperret.fr/blog/2022-05-20-et-toi-qu-est-ce-que-tu-fiches.html) <img src="https://hot-objects.liiib.re/pad-numerique-en-commun-fr/uploads/d2857129-4996-4d47-81dd-91e2a0499c10.png" width="100%"> <img src="https://hot-objects.liiib.re/pad-numerique-en-commun-fr/uploads/07d4b776-6018-4f00-95a3-3a32513eda8b.jpg" width="100%"> :::success **Outil 5 : [Logseq](https://logseq.com/)** Logseq est un logiciel libre de prise de notes. Les notes sont des fichiers textes rédigés en syntaxe markdown. C'est un logiciel équivalent au populaire [Obsidian](https://obsidian.md/), qui bien que gratuit n'est pas libre. Tout deux ont un grand écosystème de plugins qui permettent de nombreux cas d'usages. ::: <iframe width="100%" height="315" src="https://www.youtube.com/embed/BhHfF0P9A80?si=7kKCQxsAJQMKsz4C" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> :::success **Outil 6 : Les Git-based CMS** cf [Tour d'horizon des CMS Headless basés sur Git](https://www.teotimepacreau.fr/blog/git-based-headless-cms/) ::: ## 10h15 Ok, mais comment choisir ? On commence par un temps de lecture de l'article ["Choisir un outil numérique, comment faire ? un guide par l'Établi Numérique"](https://letab.li/blog/2022_05_outils/). Ensuite, à partir du "cahier des charges pour ma documentation" réalisé hier, et des connaissances acquises ce matin, je mets par écrit en quelques lignes : vers quel type d'outils je pense me tourner pour produire ma documentation, et de quelle manière ? Ensuite, chacun·e présente sa production aux autres stagiaires au cours d'un tour de table. ## 10h45 Pause ## 11h00 Cas pratique : je crée une page sur le YesWiki de la formation 🛠 Les stagiaires peuvent commencer à documenter leur projet en explorant les outils présentés, [sur le YesWiki de la formation](https://ferme.yeswiki.net/documentation-ping/?PagePrincipale). 1) premier défi => trouver le nom d'une page - regardez l'url de la page "Stagiaires" - le nom de cette page est le mot se situant après le ? 2) deuxième défi => créez une page à votre nom - copiez l'url : https://ferme.yeswiki.net/documentation-ping/? - collez cette url dans votre barre d'adresse en ajoutant votre prénom après le point d'interrogation, par exemple : https://ferme.yeswiki.net/documentation-ping/?Meven - laissez vous guider pour créer la page. 3) troisième défi => insérer un bouton dans votre nouvelle page - cliquez sur "éditer la page" ou double cliquez dans la page, - cliquez sur composants / boutons et laissez vous guider, - cliquez sur "insérer dans la page", - sauvez - vous pourrez ensuite explorer les autres composants 4) quatrième défi => modifier votre bouton - passez la page en mode édition, - cliquez sur la ligne correspondant au code du bouton (commençant par {{button}})=> un petit crayon apparaît dans la marge, - cliquez sur le petit crayon et changez les paramètres, - cliquez sur "mettre à jour le code", - sauvez - Cette démarche de modification fonctionnera pour tous les codes des composants 5) cinquième défi => ajoutez une image - passez la page en mode édition, - cliquez sur le bouton "fichier" pour téléverser une image - laissez vous guider et inserez l'image dans votre page - sauvez 6) sixième défi => ajoutez un lien vers votre nouvelle page dans la page "Stagiaires" - copiez l'url de votre page nouvellement créée - rouvrez la page Stagiaires et cliquez sur "éditer la page" ou double cliquez dans la page - ajoutez sur votre prénom un lien pointant vers votre nouvelle page - sauvez ## 12h00 Exploration de do·doc : réalisation d'un film en stop motion Après avoir regardé la vidéo tutoriel suivante : https://dodoc.fr/tutoriaux/faire-un-stop-motion On réalise collectivement un petit film avec le logiciel do·doc. ## 12h30 PAUSE ## 13h30 Mise en pratique : À partir du projet de nano-musé, les stagiaires passent à l'action en explorant les outils présentés, par exemple [sur le YesWiki de la formation](https://ferme.yeswiki.net/documentation-ping/?PagePrincipale), sur le wiki technique fablabo.net, [sur les pads CodiMD de PiNG](https://pad.numerique-en-commun.fr/), ou encore sur un wiki créé pour l'occasion. Il est possible de faire des pauses selon les besoins dans cette séquence. ## 16h00 - Présentation des réalisations effectuées https://airtable.com/appYXzP7SrjeBrZew/pagH3hQxaHNxCefFS/form ## 16h30 Tour de table : fin de la formation Pépites et cailloux. ## Emargement et évaluation de la formation [**>LIEN VERS LE QUESTIONNAIRE D'ÉVALUATION<**](https://cloud.seatable.io/dtable/forms/e6a8b4fe-eaec-4be4-b735-ea751a53079e/) ## Ressources pour aller plus loin 📖 - [Blog d'Arthur Perret, doctorant travaillant sur la documentation](https://www.arthurperret.fr/) - [Blog d'Antoine Fauchié, doctorant travaillant sur la publication numérique](https://www.quaternum.net/) - [Ressources sur le Personal Knowledge Management (PKM)](https://pkm.diagram.institute/#/page/PKM%20Bro%20Bootcamp) - [Formations sur les écritures numériques par la Chaine de recherche du Canada sur les écritures numériques](https://ecrituresnumeriques.ca/fr/2021/9/7/Debugue-tes-humanites---Formation-de-la-Chaire-de-recherche-du-Canada-sur-les-ecritures-numeriques) - Des applications couteaux-suisses pour compresser une image, convertir un fichier, formater un texte... [DevToys](https://devtoys.app/) (Windows) [DevTools-X](https://github.com/fosslife/devtools-x/) (Linux) - [De la nécessité d’une mémoire lesbienne numérique](https://friction-magazine.fr/de-la-necessite-dune-memoire-lesbienne-numerique) - [Cosma, un logiciel pour faire des fiches et des graphes](https://cosma.graphlab.fr/) - [La mémoire collective sonore de PiNG](https://ressources.pingbase.net/fiches/de-quoi-nos-ateliers-sont-ils-faits-une-memoire-collective-sonore) - [Radical Technology – Food & Shelter, Tools & Materials, Energy & Communications, Autonomy & Community (1976) pdf](https://www.energieblogger.at/wp-content/uploads/2017/05/RadicalTechnology.pdf) - [Maison rustique du XIXème siècle](http://oldu.fr/docs/1_Manuels/Maison_rustique_du_XIXe_siecle_tome_3.pdf) - [Whole Earth Catalog, fall 1968](https://monoskop.org/images/0/09/Brand_Stewart_Whole_Earth_Catalog_Fall_1968.pdf) - [Project Kamp](https://projectkamp.com/) - [Documentation des logiciels libres utilisés par l'association PiNG au quotidien](https://ressources.pingbase.net/fiches/des-outils-libres-pour-les-tiers-lieux-et-les-autres) https://annas-archive.org/ https://sci-hub.3800808.com/ https://unpaywall.org/welcome ------ L'association PiNG en bref : - [Infos et agenda](https://info.pingbase.net/) - [Espace de ressources numériques](ressources.pingbase.net/) - [Wiki technique](https://fablabo.net/wiki/Accueil) - [Forum associatif](co.pingbase.net/) - [Contact](mailto:info@pingbase.net) :::success :mega: **Ce pad a été créé par l'équipe de l'[association PiNG](https://info.pingbase.net/)** dans le cadre de la formation professionnelle *[Documenter des projets pour contribuer aux communs](https://info.pingbase.net/formations/)*. :::