Bonnes pratiques no-code #1 : commenter et documenter son projet
Вставка
- Опубліковано 28 чер 2024
- Dans cette nouvelle série de vidéos, on s'intéresse aux bonnes pratiques d'utilisation des outils no-code.
Pour cette première vidéo, on voudrait insister sur l'importance et l'intérêt de commenter/documenter ses projets réalisés en no-code.
Pour cela, on a utilisé les exemples de 5 outils différents :
- Appsheet
- Zapier
- Airtable
- Bubble
- Integromat
Bien vu! Merci. Je connais ces outils et pourtant j'étais passé à côté.
Je rejoins Floo la documentation générale d’un projet complet 😅 Notion, wiki, ... par contre tu as un véritable point avec la nomenclature
Super sujet avec des propositions concrètes ! J'ai quand même l'impression qu'il manque la vision globale de la doc. La plupart du temps on obtient un ensemble de fonctionnalités en interconnectant des services différents (saas, no-code, low-code, 100% code) et la "map globale" devient primordiale pour toute personne souhaitant appréhender un projet (ou revenir dessus après quelques mois). Par exemple à l'échelle du projet : que font AirTable, Integromat, Retool et Gmail ? De notre côté on commence à faire la doc "générale" dans Notion en y intégrant des schémas fait sur Google Slide ou Lucidchart mais c'est encore très manuel. Peut-être qu'un jour arrivera un outil "magique" qui se connectera à nos outils saas, no-code et pourra générer automatiquement des éléments de la documentation générale que l'on pourrait compléter manuellement. Et vous chez Contournement, vous faite de la doc "générale" ? Vous l'inscrivez où ?
Merci pour ton retour. Tu as tout à fait raison et en faisant la vidéo je me suis dit qu'il faudrait sûrement en faire une autre dédiée vraiment à la documentation globale d'un projet no-code. Surtout ceux qui ont une stack avec plusieurs outils interconnectés. Cela dis pour cela il faut établir un peu de méthodo car il n'y a pas encore d'outil qui le fera seul (mais c'est une idée faudrait le faire ;)). De notre coté, on fait des choses assez simples actuellement avec Notion, des vidéos et des schémas fait dans Slides.
Si jamais vous voulez documenter un peu plus votre méthodo de documentation, parlons-en :)
@@Contournement Roo le piège ! on est pas loin de zéro sur la méthodocumentation :-) On a de la doc sur Google Docs, sur Notion, dans les outils/code et rien n'est homogène... C'est un sujet assez nouveau pour nous.
Le seul truc que je vois d'assez clair pour le moment c'est de bien séparer :
- la partie à destination du "client" (spécifications, rapports d'intégrité, liste de tests, liste des briefs - demandes avec leur justification -, qui contacter en cas de problème...)
- la partie tech avec des explications sur les choix qui ont été faits (plugins, services) + schémas + en haut une section "Map Globale" qui liste succinctement les grandes lignes du projet. Le reste se fait plus naturellement mais on oublie souvent d'expliquer la base.
C'est pas fifou, j'attends ta prochaine vidéo sur le sujet avec impatience :-)
@@flool2143 C'est déjà pas mal ! Le truc c'est qu'on fait pas du tout de presta et de production en no-code pour des clients. Donc on documente que notre utilisation interne (important à documenter cela dis). Donc il va falloir que je fasse un peu de recherche sur les bonnes pratiques de ce coté là. Si t'avances un peu là dessus ça sera d'autant plus intéressant d'en parler
Avec Notion il me semble que, mise à part nommer explicitement les bases de données et les pages et insérer une icône parlante, on soit obligés de créer un bloc pour décrire le projet... Y a-t-il un autre moyen ? Les commentaires ?
Oui effectivement rien de plus dans Notion directement. Mais tu as le champs libre pour créer le contenu que tu souhaites dans les blocs