Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

édition du tuto #23

Open
laem opened this issue Jan 15, 2021 · 1 comment
Open

édition du tuto #23

laem opened this issue Jan 15, 2021 · 1 comment

Comments

@laem
Copy link
Collaborator

laem commented Jan 15, 2021

On peut le faire en yaml ou markdown, mais l'enjeu est l'intégration des images, qui représentent ~1go.

Pour faire simple, on va faire un deuxième repo qui évitera d'alourdir celui-ci. Webpack nous permettra de créer des vignettes.

Peut-être que TinaCMS peut nous aider à éditer ce tuto simplement avec notamment un sélectionneur graphique d'images, mais c'est peut-être une mauvaise solution, mieux vaut peut-être simplement bien ordonner les chemins imbriqués des images bien nommées, ce qui rend la référence dans le texte source super simple.

@laem
Copy link
Collaborator Author

laem commented Jan 21, 2021

Je note qu'on pourrait écrire le tuto sur wikifab.org, qui est déjà vachement adapté à ce genre de recettes de construction, c'est la caverne d'Alibaba ! .

Mais :

  • je ne suis pas familier avec MediaWiki et mon expérience avec un tel wiki n'était pas géniale quand il s'agit de le faire évoluer (par exemple : pas de CD, dev à l'ancienne directement sur serveur de prod, documentation très moyenne)
  • il manque des choses qui me sont importantes, comme la somme automatique des prix des composants et outils, et plein d'autres fonctions spécifiques
  • je préfère gérer les images sur un système de fichier (git/github pour l'instant) que via un file upload, notamment vu la quantité de photos
  • j'aimerais que le tuto puisse faire des références aux composants et différentes étapes qui sont des pages
  • l'évolution du tuto sur github se fait via pull request et discussions, avec des preview possibles, bref comme un logiciel classique, donc de façon plus complète / rigoureuse que sur mediaWiki

Je suis tout à fait conscient du fait que ça peut rend l'édition moins accessible que sur WikiFab, mais il me semble que ce genre de projet évolue de toute façon qu'avec un petit jeu de contributeurs passionnés, plutôt qu'un gros nombre de contributeurs passagers.

Itérons !

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant