# Documents et notes

Deux façons distinctes de garder du contenu dans Joseph : les **Documents**, partagés et classés, et les **Notes**, personnelles et libres.

## Documents

Un document est, au choix, **un fichier**, **une URL**, ou **un texte Markdown** — décidé une fois pour toutes à sa création (en changer reviendrait à en créer un autre). Chaque document :

- appartient à une **catégorie** (définie au niveau de l'espace, voir [[Gérer un espace]]) ;
- peut être **rendu public** — visible dans tout l'espace, y compris sans être rattaché à quoi que ce soit ;
- peut être **rattaché** à un ou plusieurs projets et/ou éléments à la fois.

La page globale « Documents » (barre latérale) ne montre que **vos propres** documents ; l'onglet Documents d'un projet montre **tout** ce qui appartient au projet, y compris ce que d'autres membres y ont ajouté — voir [[Travailler dans un projet]].

![La page Documents — recherche, filtre par projet et catégorie](/documentation/assets/documents-index.png)

### Le lien avec les Rapports

Un rapport généré (voir [[Rapports]]) et conservé (case « Garder » cochée) **devient un Document ordinaire** — pas un objet à part. Il hérite donc automatiquement de tout ce que les Documents savent déjà faire : rattachement à un projet ou un élément, apparition dans l'onglet Documents, ouverture directe depuis Joseph. Rien n'a été réinventé pour les rapports : ils empruntent l'infrastructure existante des Documents plutôt que d'en créer une nouvelle.

## Notes

Une note est un texte libre en Markdown, toujours **possédée par son auteur**. Comme un document, elle peut être rattachée à des projets et/ou des éléments — mais une note **sans aucun rattachement** reste visible uniquement par son auteur, quel que soit son réglage de visibilité (contrairement à un document public, qui reste visible même sans rattachement).

Les notes se retrouvent par **étiquette** — une note peut en porter plusieurs, pour la retrouver par thème depuis la page globale « Notes ».

![La page Notes — recherche, filtre par projet et étiquette](/documentation/assets/notes-index.png)