# Formation à la Documentation - CAPTL ::: info Ce pad est écrit en [**syntaxe Markdown**](https://www.arthurperret.fr/tutomd/). Il est accessible à toute personne ayant connaissance de l'URL. :::  ## 9h00 - Accueil, tour de table ☕️ - Présentation de la formation et de son cadre - Tour de table : présentation des stagiaires et (en option) des attentes de chacun⋅e concernant la formation, présentation du formateur et de l'association PiNG. ## 9h20 - 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 ? ... ## 9h40 - Introduction à l’écriture collaborative et à la syntaxe markdown 👨‍💻 [Lien de la présentation](https://hackmd.io/@hindelstark/HyK8cZLFF#/) :::warning Après la formation, en autonomie, chaque stagiaire pourra suivre 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 :**  ## 10h00 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 : ## Vidéo de Monsieur Bidouille ## **la documentation** c'est un ensemble d'informations données par tous. C'est un mouvement en expension. base, je partage, mais je ne documente pas. Documenter est différent de partager. Créer une base et ajouter des infos. Photos, explications. C'est une démarche de partage de connaissances mais avec explications.Ce peut-être varié version amateur comme professionnel tout le monde y trouve son interet. Les formes et les frmats peuvent êtr e différents. Attention aux formats déposés. **Partage du savoir** Connexion comme les fourmis ! les humains n'ont rien inventé partager n'est pas documenter... montre le chemin parcouru et de permettre aux autres de faire pareil mais différemeent... L'esprit s'inspire d'une idée posée à l'autre bout de la planete. et d'améliorer les idées posées dans le pot commun pas seulement local mais mondial. **Pratiques alternatives** Le partage n'est plus pyramidale mais collegial. Permettant ainsi a chacun de prendre sa place en exprimant une compétence, facilité qui serait passée inapercue dans une organisation hiérarchique. **Conclusion** L'innovation est le fruit d'un savoir collectif qui doit être accessible à tous *Annexe* : [Tuto vidéo guitare du Fossoyeur de film](https://www.youtube.com/watch?v=gERxjVUqwgY) //// LA PRISE DE NOTE DU GROUPE 2 COMMENCE CI-DESSOUS : ## Notes Olivia ## Le **partage d'informations** : mouvement maker de plus en plus d'ampleur. La documentation : mettre le fichier sur Internet Mais le coeur de la documentation c'est ajouter un élément supérieur ! Le partage sous la numérique est d'ajouter des éléments (chemin parcouru, et parcourir le même chemin) La documentation est une base de données avec des éléments de savoir-faire.Bel exemple sur l'imprimante 3D. Une documentation peut varier sous forme We are makers ou les Wiki. L'innovation est le fruit d'*un travail collectif*. ## Notes Hélène ## Partage de connaissance et de savoir. Sous forme de WIKI. Alimenter les autres. Faire ensemble. **Phénomène des makers.** Partage d'informations sur un cloud pour documenter. Partage sous forme numérique d'un projet. Emprunter une voie alternative avec beaucoup de solutions. Nils Garsonfil à inviter les Fablab Documenter est à la portée de tous et le but est de faire ensemble. Ils existent de nombreux sites pour documenter : thinginverse... ## 10h45 - 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) ## 11h10 Pause ## 11h20 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."* Préambule 2 : [*Choisir un outil numérique, comment faire ?* un guide par l'Établi Numérique](https://letab.li/blog/2022_05_outils/) ::: ### 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). ::: ## 12h - 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 ## Évaluation de la formation :  ## Émargement Voir dans le classeur pédagogique orange à l'accueil ## Et après la formation : Quel cahier des charges pour ma documentation ? 📝 Chaque participant⋅e commencer par poser ses besoins et ses envies, en remplissant le cahier des charges de sa documentation sur la trame proposée. [Lien vers la trame écrite (.pdf)](https://station.pingbase.net/index.php/s/waRz2zTnGjwxd6L) [Lien vers la trame écrite éditable (.odt)](https://station.pingbase.net/index.php/s/3PDQPXnJKmGgLYN) ## 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 (.pdf)](http://oldu.fr/docs/1_Manuels/Maison_rustique_du_XIXe_siecle_tome_3.pdf) - [Whole Earth Catalog, fall 1968 (.pdf)](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) ------ 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/)*. :::