Documentation

Votre savoir, écrit une fois, lisible par les bonnes personnes.

Documentation donne un foyer aux procédures, aux guides et aux références de l'organisation : autant de documentations que de sujets, chacune avec son sommaire, ses couleurs et son public. La même page sert le manuel interne de l'équipe et le site public des clients — ce qui change, c'est qui a le droit de l'ouvrir.

Un sommaire, pas un dossier

Des pages imbriquées sur trois niveaux, réordonnées à la souris. Le plan du manuel est la navigation du lecteur.

On voit qui écrit

Quand quelqu'un modifie une page, tout le monde le voit à la seconde — dans le sommaire comme dans la page.

Public, interne, ou à quelques-uns

Le réglage se fait documentation par documentation, et se change sans déplacer une seule page.

À votre marque

Huit couleurs règlent tout le site publié : fond, texte, titres, liens, sommaire, code. Aucune trace d'Eos.

Autant de documentations que de sujets

Le manuel interne, le guide client et les procédures RH n'ont ni le même public ni le même ton. Ici ce sont trois documentations, chacune avec son sommaire, ses couleurs et ses droits — au lieu d'un unique dossier où chacun range comme il peut et où personne ne trouve rien.

  • Chaque documentation a son adresse et son sommaire
  • Pages imbriquées, déplaçables à tout moment
  • Le lien d'une page survit à son déplacement

Écrire à plusieurs sans se marcher dessus

La question avant de taper dans une page est toujours la même : est-ce que quelqu'un y est déjà ? Le sommaire marque les pages occupées, la page nomme qui l'a ouverte, et un point s'anime dès que la personne écrit vraiment. Rien à rafraîchir, rien à demander sur une messagerie.

  • Présence en direct, page par page
  • « En cours de modification » quand ça tape, pas quand ça lit
  • Le texte des autres arrive pendant que vous lisez

Le même manuel, trois publics

Une documentation publique est un site : une adresse lisible, aucune connexion demandée. Une documentation interne s'arrête aux membres de l'organisation. Une documentation restreinte se règle rôle par rôle et membre par membre. Le réglage change en un clic, sans rien déménager.

  • Publique : une adresse, aucun compte requis
  • Interne : tous les membres qui ouvrent le module
  • Restreinte : les rôles et les personnes que vous listez

Vos couleurs, jusqu'au bout

Un manuel publié porte votre marque, pas la nôtre. Huit couleurs — fond, surfaces, texte, titres, liens, texte discret, filets, blocs de code — règlent chaque surface du site, avec des palettes toutes prêtes pour partir vite et un aperçu qui se repeint pendant que vous choisissez.

  • Palettes prêtes à l'emploi, ou vos propres teintes
  • Aperçu immédiat, avant d'enregistrer
  • Le même thème pour l'écriture et pour la lecture

What teams do with it

Manuel interne

Procédures, onboarding, décisions — réservés à l'équipe.

Documentation produit

Un site public à votre marque, sans second outil.

Base client

Ouverte à quelques rôles, fermée au reste.

Notes d'équipe

Une documentation par projet, rangée dès le départ.

Documentation works with

Frequently asked questions about Documentation

Combien de documentations puis-je créer ?

Jusqu'à quarante par organisation, chacune avec son propre sommaire, ses couleurs et ses droits. C'est une limite de bon sens, pas un palier tarifaire.

Une documentation publique est-elle indexée ?

Oui : c'est un vrai site, avec une adresse lisible construite sur le nom de l'organisation et celui de la documentation. Les documentations internes et restreintes ne sont jamais servies sans session.

Que devient un lien quand je déplace une page ?

Il continue de fonctionner. L'adresse d'une page est la sienne, pas celle de sa position dans le sommaire — vous pouvez réorganiser un manuel publié sans casser ce qui pointe dessus.

Peut-on écrire à plusieurs sur la même page ?

Oui. La présence indique qui est sur la page et qui écrit à l'instant, et le texte des autres arrive en direct. Deux personnes tapant dans le même paragraphe restent en « dernier arrivé, dernier servi » — la présence est là pour que cela n'arrive pas par surprise.

Qui peut modifier une documentation ?

Les permissions du module (voir, créer, modifier, supprimer des pages, créer une documentation) se règlent par rôle dans les paramètres de l'organisation. Une documentation restreinte ajoute un second filtre : les rôles et les membres que vous y listez, avec leur niveau.

Learn to use Documentation

Video guides under twenty seconds, one per action.

Every page in this topic

Turn Documentation on for your organisation

Create your account for free — Documentation turns on in one click from your workspace.