documentation: étude d'une solution d'édition collaborative - Githubissues

souslesens / souslesensVocables

SousLeSensVocables is a set of tools to manage semantic web thesaurii and ontologies (SKOS,OWL,RDF)

MIT License

12 stars 9 forks source link

documentation: étude d'une solution d'édition collaborative #769

Closed xgaia closed 2 days ago

xgaia commented 3 weeks ago

Édition collaborative

👍 Avantages

facile à prendre en main

👎 Inconvénients

plus lourd à mettre en place
maintenance coûteuse
gestion de compte / permissions

👷 Solutions techniques

mediawiki ?
dokuwiki

Documentation en markdown/rst

👍 Avantages

facile et rapide à mettre en place
pas de gestion de compte et de permission (compte GitHub)
Maintenance facile

👎 Inconvénients

Édition via git ou GitHub

👷 Solutions techniques

mkdocs markdown
sphinx rst ou markdown

xgaia commented 2 weeks ago

mettre un place un mediawiki et un site en mkdocs/sphinx pour tester

xgaia commented 2 weeks ago

Une documentation est en place à cet url : https://souslesens.github.io/documentation/

Le code est ici : https://github.com/souslesens/documentation

xgaia commented 1 week ago

Il faut pouvoir télécharger la doc en PDF