• # Un Wiki

    Posté par  (site web personnel) . Évalué à 5.

    La solution peut être différente si tu veux une documentation pour un projet spécifique ou un espace hébergeant plusieurs documentations variées.

    Moi j'ai pas mal fouillé à l'époque où je cherchais à centraliser les docs de ma boite et je suis parti sur du Dokuwiki car c'est simple et en backend, c'est des fichiers texte que tu peux manipuler/scripter comme tu veux.

    J'avais écris un article sur mon blog à ce sujet. Ça date d'il y a un an mais ça peut te donner une idée.

  • # Read the docs

    Posté par  . Évalué à 5.

    Read the docs est basé sur Sphinx.

    Mais wikipedia te donne plein d'autres "documentation generators".

    Tu peux aussi utiliser docbook c'est ce que beaucoup de projets utilisent.

    Tu as aussi les ipython nootbooks pour python.

    Ruby est le résultat d'un gamin qui apprend le Java, puis jette un œil à Perl et se dit « je peux le réparer! »

  • # Tracim ?

    Posté par  (site web personnel, Mastodon) . Évalué à 5.

    Tracim est un outil de gestion des connaissances qui cible la collaboration / partage de connaissance avec des utilisateurs non techniques.

    Tu peux gérer ta doc, tes fichiers, tout est versionné et les droits d'accès sont gérés par espace de travail.

    L'interface est "moderne", basée sur bootstrap 3 (on aime ou pas ; niveau utilisateurs "non techniques" c'est bien perçu)

    Tu peux tester Tracim en ligne

    Avantages de Tracim par rapport à DokuWiki ou ReadTheDocs (ou d'autres):

    • accessible aux utilisateurs non techniques :
      • éditeur wysiwyg basé sur HTML
      • interface type "explorateur de fichier" comprise par tous
      • gestion des droits simple
    • gestion de pages et fichiers (et discussions) au sein d'un outil unique
    • tu as un historique général et tu peux marquer ton contenu lu ou non lu (donc tu sais ce qui a changé)
    • tu reçois des notifications par email lorsque quelqu'un fait une modification, et la notification t'indique le diff
    • il y a une société (la mienne) qui peut te proposer du support ou des dév spécifiques (et si ça ne t'intéresse pas, il n'y a pas de problème parce que Tracim est en vrai open-source)

    Une dépêche devrait bientôt arriver pour présenter la nouvelle version développée ces derniers mois.

  • # Merci

    Posté par  . Évalué à 1.

    Merci pour toutes vos réponses !

    En regardant de plus près DokuWiki m'a semblé le plus simple (pas de besoin de base de données ou de build).

    • [^] # Re: Merci

      Posté par  (site web personnel) . Évalué à 2.

      Attention, il y deux choses.

      La rédaction/édition et production d'un contenu utilisable sur le web.
      Format ReST, build avec Sphinx vers divers formats. Format (Doku)Wiki, génère du HTML (mais plugin pour faire du odt par exemple).

      La publication en ligne de ce contenu.
      Read The Docs fournit le service (et automatise le build en récupérant les sources sur les systèmes de dépôts). DokuWiki nécessite que tu maintiennes un serveur (ou trouve un service d'hébergement)…

      La solution DokuWiki est au premier abord plus simple. Mais ça vaut le coup à mon avis de regarder ReST + Sphinx et la publication en ligne sur Read The Docs. Le pas sur le côté rédaction / build est plus grand, mais ensuite tu gagnes car tu ne fais plus que la rédaction (et vérif que le ReST est correct).

      Python 3 - Apprendre à programmer dans l'écosystème Python → https://www.dunod.com/EAN/9782100809141

Suivre le flux des commentaires

Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.