Documenter un projet : oui, mais sous quel(s) angle(s)?

@YannickL Je parle bien d’une page internet sur le site museomix.org

1 Like

On est en train de préparer la structure de documentation sur Hackpad pour Museomix MTL et je pense que c’est vraiment le bon outil pour documenter pendant les 3 jours.

En fait, on va même l’utiliser comme outil pour centraliser les informations auxquelles les participants ont besoin d’accéder. Par exemple :

  • comment se connecter au wifi
  • comment préparer ses fichiers pour la découpeuse laser / impression 3D / vinyle
  • matériel à disposition
  • etc.

J’enverrai notre lien bientôt dans nouveau topic si ça vous intéresse.

1 Like

cc @Ludivine pour le fil d’échanges dont je t’ai parlé ce midi concernant la documentation en ligne des projets. si j’ai bien compris (j’ai un peu relaché l’attention) on partirait sur l’utilisation du hackpad (plutot que le Wordpress) ce que je trouve très bien et avec un questionnaire

Hello !
Donc, pour synthétiser ce qu’on fait à MTL :

  • les équipes utilisent Hackpad pour documenter leurs projets pendant l’événement
  • on propose un genre de structure en amont, mais en réalité, ils sont libres de mettre les informations qu’ils veulent
  • on ajoute manuellement les projets (ou une version simplifiée) sur le WP global ensuite
  • on s’est rendu compte que c’était un bon moyen de centraliser les infos pour les participants (par exemple : déroulé, infos en anglais, recommendations pour produire ses fichiers vecteur / 3D, contacts importants, etc.)
  • pour être clairs, on ne dit pas que chaque communauté doit faire de même. La documentation WP n’est pas une (trop) mauvaise solution, puisque ça a marché les années précédentes.

Pourquoi Hackpad semble être une bonne solution pendant l’événement ?

  • facile de se faire un compte / ajouter des pages
  • liberté d’utilisation / flexibilité (on peut même faire des todo listes)
  • versatilité des contenus supportés (images, code, etc.)
  • ne risque pas de faire bugger le WP ‘vitrine’
  • plateforme robuste

Et pour référence, voilà où on en est :
https://museomixmtl.hackpad.com/

2 Likes

[message MSXOUEST] @Ludivine Lilian est OK pour aider les équipes sur la documentation. Je vais le renvoyer sur ce fil et lui montrer ce que fait Montréal sur hackpad

1 Like

Bonjour

J’ai prévu la création du hackpad aujourd’hui.

Mais j’hésite entre
. 1 hackpad central et 1 hackpad par projet
ou
1 gros hackpad pour tous.

La raison : si des MMxeurs d’équipes différentes entreprennent de documenter simultanément : est ce que ça ne risque pas de ralentir l’accès au pad, donc de les gêner et de les décourager de l’utiliser ?
Qu’en pensez-vous ? Quelle solution avez vous choisie ? merci de votre retour

Merci, belle journée
et surtout super Museomix à ceux qui sont déjà dans l’aventure !!! :tada: :tada: :tada: :tada: :tada:

Yannick

salut, ça ne ralentit pas je crois pas, le truc est prévu pour faire de la co-edition simultanée
je pense que un seul hackpad c’est bien, une seule adresse. on peut faire ensuite des collections par équipes si il faut pour regrouper les pads (si jamais une équipe en fait plusieurs)

Salut,

Et grand merci @tart2000 pour l’exemple du pad ! A Guéret, ton modèle a été une véritable bouée de sauvetage. On l’a mis en place hier et on a des retours des museomixeurs de l’année dernière qui apprécient d’avoir une trame préremplie, même s’ils vont probablement l’adapter.
Pour info @YannickL, j’ai créé un workspace pour MuseomixLim, une collection Docu et un pad par équipe: https://museomixlim.hackpad.com/ep/group/yGSc986WnOf
ça a l’air de marcher !

Alina

1 Like

@YannickL si tu met en place le hackpad pour rennes, je te propose : une collection “docu” pour pouvoir filtrer sur les pads de documentation et les avoir tous d’un coup et des collections “equipe1, 2, 3” pour pouvoir laisser les équipes libres de faire d’autres pads
ça te semble bien comme ça ?
cc @Ludivine
samuel

oui ça me semble pas mal du tout
MAIS je dois creer un workspace MuseomixOuest qui n’existe pas encore ? je me trompe ? ou alors je n’ai acces qu’au workspace Museomix général.
NB trop de lag sur ma connection à cette heure. ce sera fait d’ici demain matin :slight_smile:

A Mexico aussi on a utilisé HackPad.

La seule question c’est : qui passera toute l’info sur le site ? Nous ou quelqu’un d’autre ? Et toute notre info a nous elle sera en español…

Un exemple de documentation faite par une équipe dont le proto va d’ailleurs être développé, qui peut éventuellement donner des idées

ça te dis qq chose Clém :wink:
ch

Héhé :slight_smile:

Nous on en est là :
https://hackpad.com/ep/group/nSVIFQrDxhz

yannick, voici le pad https://museomixouest.hackpad.com/ que je viens d’ouvrir

Salut à tous,
On en discutait avec Clémence en off Mixroom.
Je trouve aussi qu’hackpad est une bonne solution, robuste et versatile pour la documentation pendant l’évènement.

Je propose de faire remonter la structure de publication type de @tart2000 @samuelbausson de manière plus visible pour tous les msxs en haut de ce pad, ou ailleurs si plus adapté ?
Je rajouterais aussi le lien vers le github museomix qui fait référence, pour ne pas se disperser si les équipes veulent en utiliser une et capitalise sur 2013/2014, Samy a déjà commencé cette année.
https://github.com/museomix

Dites moi si il y a un espace je complèterai.

Good luck à tous

Yes, de notre côté, on est vraiment impressionnés par la qualité de la documentation faite par les équipes… À voir comment on utilise ça ensuite. Parce qu’on peut aussi embedder directement les hackpads en iframe sur le site .org…

1 Like

Bonjour,

Dans le Nord, nous sommes restés sur la version Drive, ne trouvant point le lien du Hackpad (ni sachant vraiment le configurer pour ma part).

Pourriez-vous nous transmette ce lien pour que nous puissions copier coller le contenu des différentes fiches prototypes du Drive local.

Merci par avance et bonne journée
Nina

N’hésitez pas à me répondre directement par Mail
à nina.debail@gmail.com

C’est un peu la folie ici :slight_smile:

salut patrick, pour déposer des choses sur le github museomix faut un login pour nous ?
cc @BenoitVallauri @bevellin

Nina, pour le hackpad il faut créer ton propre compte et ensuite ouvrir un espace (public ouvert)
les pads (= une feuille de note) sont ensuite affichés par ordre de dates de modification et on peut les filtrer par des tags “collections” à ajouter (plusieurs collections par pad sont possible).

Hello, pour ça il faut juste le compte github des développeurs. Ensuite on les intègre à la team museomix : https://github.com/orgs/museomix/people
Si vous les avez sous la main, listons les ici même en édition du post pad.
Ou en réponse sur twitter @pvin @pilooz : https://twitter.com/pvin/status/663380315998695424
(mince ce message en reply mail n’a pas été publié automatiquement…).

Un début de liste, à compléter ici :

  • vayan