Travail collaboratif autour de la documentation

Plus d'informations
il y a 1 an 2 mois #27125 par Ivan
Bonjour,

Je continue ici la discussion sur la création groupée de la documentation.

Je propose l'utilisation d'un wiki que je pourrai éventuellement héberger si besoin. Cela permettrait d'éviter un format propriétaire et de faciliter la connexion des contributeurs. Il y a Mediawiki, mais qui ne semble pas très convivial. Si vous avez d'autres idées.

Ivan

Connexion ou Créer un compte pour participer à la conversation.

Plus d'informations
il y a 1 an 2 mois #27128 par baalth
Bonjour,

Mediawiki est très bien pour ce type de documentation.
Dans la même lignée il existe MkDocs
Ou encore ReadTheDocs , qui est utilisé par django , qui nécessite un compte utilisateur, mais qui est gratuit pour les projets opensource.

Et pour débuter je propose le plan suivant à enrichir/améliorer/modifier :
  • Documentation NoethysWeb
    • Introduction
  • En auto-hébergement
    • Prérequis (Liste des points a vérifier et comment le faire)
    • Préparation (Selon le type de serveur utilisé, natif django, apache/nginx/lighthttpd)
    • Installation
    • Mise en production
    • Migration et mises à jours (modes opératoires détaillés)
  • Utilisation de la solution de l'éditeur
    • Commande (lien vers le bon de commande)
    • ...
  • Administration
    • Créations des utilisateurs
    • Créations des groupes
    • ...
  • Configuration (Partie métier)
    • Paramétrage de l'application en tant qu'utilisateur
    • Paramétrer une structure
    • Paramétrer les établissements.
    • Configurer les activités
    • ...
J'espère que cela te fera gagner un peu de temps.

baalth

Connexion ou Créer un compte pour participer à la conversation.

Plus d'informations
il y a 1 an 2 mois #27131 par Fred.th
Mediawiki : je pratique couramment mais c'est peut-être un peu lourd pour l'usage ?

Je pense que les critères de choix sont :
  1. pour toi Ivan : pas de prise de tête à déployer/maintenir
  2. facile à exporter/exploiter (livret papier, site statique)
  3. gère bien les images (copies d'écrans) : nommage, mise en page, accessiblité
  4. facile à modérer par la communauté : troll, spam, maladresse -> implique des fonctions d'effacement, de revert et de suivi

Fred.th, pour le Relais des Enfants à Montpellier
www.relaisdesenfants.org

Connexion ou Créer un compte pour participer à la conversation.

Plus d'informations
il y a 1 an 2 mois #27132 par gdufranc
Effectivement, mediawiki est peut être un peu lourd a installer et maintenir, même si je l'utilise au quotidien, je pense que pour une utilisation dédiée à noethys c'est un peu surdimensionné

Il y a dokuwiki qui est plus léger, plus simple et sans doute plus adapté : https://www.dokuwiki.org

Sinon on peut aussi faire ça directement sur github.

Gael.

Connexion ou Créer un compte pour participer à la conversation.

Plus d'informations
il y a 1 an 2 mois - il y a 1 an 2 mois #27133 par guerdal
+1 pour Dokuwiki, les seuls besoins sont un serveur web, un php et des fichiers textes. Pas de BDD donc facile à backuper et maintenir

C'est ce que j'utilise au boulot

Et il y a un plugin Git : https://www.dokuwiki.org/plugin:gitbacked
 
Dernière édition: il y a 1 an 2 mois par guerdal.

Connexion ou Créer un compte pour participer à la conversation.

Plus d'informations
il y a 1 an 2 mois #27134 par Ivan
Adjugé vendu pour Dokuwiki.

Je l'ai installé ici : https://noethys.com/nwaide
Vous pouvez créer un compte dès à présent dessus.

Ivan

Connexion ou Créer un compte pour participer à la conversation.

Plus d'informations
il y a 1 an 2 mois #27135 par guerdal
Compte créé

J'ai incorporé la proposition de plan de baalth, afin de permettre de commencer :-)

Je vais initier la partie autohébergement, si certains veulent me corriger c'est avec plaisir

Connexion ou Créer un compte pour participer à la conversation.

Plus d'informations
il y a 1 an 2 mois #27137 par JKZ
Bonjour,

J'ai rédigé une mini procédure à destination des utilisateurs Noethys et j'ai aussi une petite vidéo pour aider à réserver.

Je veux bien mettre en commun :)

Juliette

Connexion ou Créer un compte pour participer à la conversation.

Plus d'informations
il y a 1 an 2 mois #27138 par Ivan
Bonjour,

Pour l'instant, je ne peux pas contribuer car le développement de NW me prend trop de temps.
Toutes les énergies sont donc les bienvenues !

Ivan

Connexion ou Créer un compte pour participer à la conversation.

Plus d'informations
il y a 1 an 2 mois #27140 par JKZ
Bonjour,

J'ai ajouté plusieurs petites procédures.

N'hésitez pas à retravailler dessus car elles sont adaptées à mon asso (école associative en multisites).
De plus n'ayant pas de procédure on a fait un peu au feeling certains points (et parfois on a découvert mieux par la suite donc si vous avez des tips )

Juliette
Les utilisateur(s) suivant ont remercié: Fred.th

Connexion ou Créer un compte pour participer à la conversation.

Temps de génération de la page : 0.306 secondes
Propulsé par Kunena