Écrivez et gérez vos documentations avec BookStack

Magazine
Marque
Linux Pratique
Numéro
110
Mois de parution
novembre 2018
Spécialité(s)


Résumé
La documentation, sa rédaction et son contenu, sont souvent repoussés en fin de projet. Alors que c’est souvent le plus important pour vos utilisateurs : une documentation inexistante ne motivera personne à utiliser votre projet. Une documentation obsolète frustrera votre communauté et fera fuir de potentiels nouveaux utilisateurs. La bonne documentation de votre projet, au même titre que son utilité et sa qualité, fait partie intégrante de sa réussite. Il existe déjà plusieurs solutions, dédiées et souvent complexes, ou d’autres qui détournent des applications CMS ou Wiki. Dans cet article, nous allons découvrir BookStack.

1. Introduction

BookStack [1] est une application web minimaliste pour rédiger, gérer et publier votre documentation. Minimaliste, car elle se concentre sur la documentation, et n’est pas pensée pour gérer une large sélection de types de contenus différents comme d’autres CMS ou wikis existants. Minimaliste, car elle offre une expérience utilisateur intuitive : un nouvel utilisateur ne sera pas submergé par une tonne d’options et menus, et pourra facilement commencer à utiliser l’éditeur WYSIWYG pour participer à la documentation, ou rechercher du contenu. Mais BookStack n’est pas simpliste pour autant : tout utilisateur avancé pourra utiliser Markdown pour la rédaction, gérer finement les droits d’accès ou encore personnaliser l’interface selon ses goûts personnels ou aux couleurs de sa société.

2. Installation

BookStack n’est disponible qu’en version 0.23, mais est tout à fait utilisable. BookStack...

Cet article est réservé aux abonnés. Il vous reste 90% à découvrir.
S'abonner à Connect
  • Accédez à tous les contenus de Connect en illimité
  • Découvrez des listes de lecture et des contenus Premium
  • Consultez les nouveaux articles en avant-première
Je m'abonne


Article rédigé par

Abonnez-vous maintenant

et profitez de tous les contenus en illimité

Je découvre les offres

Déjà abonné ? Connectez-vous