Bel exemple de la Charrette : https://charrette.bike/pdf/documentation.pdf
1 « J'aime »
chez nous il y a eu des arbitrages sur la doc. Pour qu’elle soit le plus évolutive et participative possible des outils type git / readthedocs sont testés. Mais par conséquent c’est pas aussi beau que Veloma (charrette) qui a missionné une graphiste. Dilemme 
On pourrait aussi décider de sortie une belle doc de temps en temps, qui serait une photographie de la doc à un moment précis, joyeusement mise en page (ce que fait par exemple l’association tripalium avec ses guides de construction d’éoliennes)
1 « J'aime »
Dans mon univers d’imprimantes 3D, voici ce avec quoi nous travaillons, c’est parfait !
1 « J'aime »
Ca n’est pas très sexy, c’est un prototype issu d’un projet Européen, mais ça a le mérite d’exister.
Se poser la question de la documentation, c’est aussi se poser la question de l’ouverture et donc du niveau d’information que l’on délivre et pourquoi. Souhaite t on permettre la duplication, la réutilisation, l’enrichissement de la conception ?
Le template ne donne pas la réponse à ces questions, mais juste explore TOUTES les informations pertinentes à fournir dans un idéal d’open-source total (définition de l’OSHWA : study, make, replicate, sell).
2 « J'aime »
En effet, sujet majeur dont nous devrions avoir un petit atelier du jeudi matin dédié ! qu’en pensez vous @psl3d @constance-rfflabs @Vehicule_Techno @pierre_vspt
1 « J'aime »
Oui le sujet de la documentation est pas évident. Sur le vhélio on est parti sur git + le format Myst (une sorte de Markdown augmenté qui est utilisé notamment par Readthedoc).
Personnellement, je trouve ça super, mais je me rends compte que ça ajoute un niveau de complexité non négligeable pour les néophytes.
L’idée était de pouvoir permettre à tout le monde de contribuer à la doc en toute autonomie (via le mécanisme de « Pull Request »), en pratique, c’est finalement les personnes qui maîtrise l’outil technique qui devait centraliser les modifs et les faire elles-mêmes.
De plus, le rendu PDF a été difficile à bien calibrer, ces documentations étant plutôt faites pour du rendu HTML.
Nous sommes arrivé à quelque chose de plutôt joli (pas autant que Veloma bien sûr) et ça pourrait être intéressant de vous partager notre expérience.
Je pense qu’il sera important de bien documenter aussi la procédure qui permet de contribuer à la doc, pour l’instant c’est encore trop compliqué.
Dispo un jeudi matin si vous voulez (faudra que je prévienne le boulot).
Bonne journée,
Andréas
3 « J'aime »
Merci pour ces retours très riches ! Ce sujet est le coeur du réacteur si on veut avoir 5% de personne capable de documenter dans chaque communauté/projet
Cc @jaime
1 « J'aime »
Viens d’organiser l’Atelier du 20 avril sur ce sujet ! Faites circuler l’info
https://wiki.lafabriquedesmobilites.fr/wiki/Atelier_XD_58_documentation
en espérant avoir les équipes de Vhélio, Charette cc @veloma @Vehicule_Techno
1 « J'aime »
Super, je note la date !
Ce guide vient d’être rédigé pour la documentation de vos projets Guide de documentation pour l'extrême Défi — Communauté de la Fabrique des Mobilités
le CERN vient de mettre à jour sa plateforme pour héberger des projets open source Hardware : CERN’s new Open Source Program Office | CERN
pour Vhélio et Mosquito ? cc @marcl73 @Vehicule_Techno
1 « J'aime »
un tuto pour fabriquer un pédalier générateur.en licence creative commons CERN weakly reciropal. Le tuto est réalisé avec le low tech lab de Concarneau. Le pédalier a été testé pendant qlq mois dans le désert mexicain.Un reportage sur Arte montre les différentes étapes.
https://wiki.lowtechlab.org/wiki/Pédalier_générateur
2 « J'aime »
On étoffe nos ressources pour le vhélio. La documentation ne suffit pas, certaines personnes ont besoin d’éléments visuels, de conseils annexes…
On a cette page wiki qui répond à beaucoup de questions récurrentes : S'approprier le projet vhélio — Wiki vhélio
Et on a désormais ces vidéos, ça redit des mêmes choses mais en vidéo, et on peut visuellement se représenter un atelier d’assemblage : https://www.youtube.com/@vhelio8311/streams
Et enfin un timelapse « assemblage de 3 vhélios », on ne voit pas tous les ateliers annexes mais ça donne aussi une idée de l’orga de l’espace https://www.youtube.com/watch?v=hQUqz2tM1wQ
1 « J'aime »
Un projet en cours de développement intéressant pour les projets utilisant FreeCAD:
OSH Automated Documentation Il s’agit d’un « Workbench » qui permet de générer un beau PDF imprimable avec des vues pour les étapes de montage.
2 « J'aime »
super,
ça pourrait grandement nous servir (vhélio).
Jusqu’à présent on utilise un workbench « fait maison » par un de nos bénévoles (démo ici).
2 « J'aime »