Initial vault setup
This commit is contained in:
@@ -0,0 +1,113 @@
|
||||
---
|
||||
title: Docs
|
||||
created: 2026-06-07
|
||||
updated: 2026-06-07
|
||||
type: app
|
||||
tags: [catalogue, note-taking, docs, collaboration, wiki, documentation, django, react, docker]
|
||||
confidence: high
|
||||
contested: true
|
||||
sources: [https://selfh.st/apps/?tag=Note-Taking, https://github.com/suitenumerique/docs, https://docs.numerique.gouv.fr/docs/]
|
||||
---
|
||||
|
||||
# 🧾 Docs
|
||||
|
||||
> **L'outil d'écriture collaborative de La Suite numérique**, pensé pour rédiger, partager et organiser des documents à plusieurs, entre la note collaborative, le wiki et la documentation d'équipe.
|
||||
|
||||
## 📋 Informations Générales
|
||||
|
||||
| Champ | Valeur |
|
||||
| :--- | :--- |
|
||||
| **Site web** | [docs.numerique.gouv.fr/docs](https://docs.numerique.gouv.fr/docs/) |
|
||||
| **GitHub** | [suitenumerique/docs](https://github.com/suitenumerique/docs) |
|
||||
| **Licence** | MIT, avec certaines fonctionnalités avancées dépendant de composants non MIT selon le dépôt |
|
||||
| **Langage** | Python, TypeScript |
|
||||
| **Étoiles GitHub** | 16.6k ⭐ |
|
||||
| **Dernière MAJ** | 2026-06-05 |
|
||||
| **Catégorie** | [[cat-note-taking|Note-Taking]] |
|
||||
|
||||
## 📝 Description
|
||||
|
||||
**Docs** est une plateforme de **rédaction collaborative, wiki et documentation** développée dans l'écosystème **La Suite Numérique**. Le projet parle explicitement de **notes collaboratives**, de hiérarchie documentaire, de partage granulaire, d'export et même d'assistance IA.
|
||||
|
||||
Comme pour Outline ou Etherpad, il faut nuancer : **Docs n'est pas avant tout une app de notes personnelles**, mais plutôt un outil de **documents collaboratifs structurés**. Il entre bien dans cette catégorie si l'on parle de **prise de notes en équipe**, de capitalisation de connaissances et de documents vivants.
|
||||
|
||||
Points notables :
|
||||
|
||||
- ✅ Collaboration temps réel
|
||||
- ✅ Hiérarchie de documents et sous-documents
|
||||
- ✅ Import `.docx` / `.md`, export `.docx` / `.odt` / `.pdf`
|
||||
- ✅ Positionnement souverain / secteur public français
|
||||
- ✅ Self-hosting documenté
|
||||
- ⚠️ Produit plus proche d'un **éditeur documentaire collaboratif** que d'un carnet personnel
|
||||
|
||||
## 🚀 Installation
|
||||
|
||||
### Option recommandée : Docker Compose
|
||||
|
||||
Le dépôt mentionne un support Docker Compose pour le self-hosting, ainsi qu'un environnement de développement basé sur Docker, MinIO et Make.
|
||||
|
||||
```yaml
|
||||
services:
|
||||
docs:
|
||||
image: ghcr.io/suitenumerique/docs:latest
|
||||
container_name: docs
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- "3000:3000"
|
||||
env_file:
|
||||
- .env
|
||||
depends_on:
|
||||
- db
|
||||
- minio
|
||||
|
||||
db:
|
||||
image: postgres:16
|
||||
|
||||
minio:
|
||||
image: minio/minio:latest
|
||||
command: server /data
|
||||
```
|
||||
|
||||
## ⚙️ Configuration Initiale
|
||||
|
||||
1. **Préparer les variables d'environnement** décrites par le dépôt.
|
||||
2. **Déployer la base et le stockage objet** si l'on vise un usage durable.
|
||||
3. **Créer les premiers comptes et espaces documentaires**.
|
||||
4. **Définir les permissions** de lecture, commentaire et édition.
|
||||
5. **Décider si l'assistant IA doit être activé** dans le contexte concerné.
|
||||
6. **Configurer HTTPS et sauvegardes** avant usage par une équipe.
|
||||
|
||||
## 🔄 Alternatives
|
||||
|
||||
### Open Source
|
||||
- [[app-outline]] — Base documentaire d'équipe très soignée
|
||||
- [[app-etherpad]] — Collaboration temps réel plus brute et immédiate
|
||||
- [[app-appflowy]] — Workspace plus généraliste
|
||||
- [[app-affine]] — Docs + canvas + tables
|
||||
- **BookStack** — Wiki plus simple à administrer
|
||||
|
||||
### Propriétaires
|
||||
- **Google Docs**
|
||||
- **Notion**
|
||||
- **Confluence**
|
||||
- **Microsoft 365 / Word Online**
|
||||
|
||||
## 🔐 Sécurité
|
||||
|
||||
- ✅ Le site officiel met en avant une approche **souveraine** et des audits de sécurité dans son contexte public
|
||||
- ⚠️ Les documents collaboratifs peuvent exposer beaucoup d'information sensible si les liens de partage sont mal gérés
|
||||
- ✅ Prévoir authentification, HTTPS, sauvegardes et rétention des exports
|
||||
- ⚠️ Vérifier les composants optionnels non-MIT si vos contraintes juridiques sont strictes
|
||||
|
||||
## 📚 Ressources
|
||||
|
||||
- [Présentation officielle de Docs](https://docs.numerique.gouv.fr/docs/)
|
||||
- [GitHub suitenumerique/docs](https://github.com/suitenumerique/docs)
|
||||
- [Documentation d'installation dans le dépôt](https://github.com/suitenumerique/docs)
|
||||
|
||||
## Pages Liées
|
||||
|
||||
- [[cat-note-taking]] — Catégorie Note-Taking
|
||||
- [[app-outline]] — Alternative proche pour wiki/documentation
|
||||
- [[app-etherpad]] — Collaboration synchrone plus simple
|
||||
- [[app-appflowy]] — Workspace documentaire plus large
|
||||
Reference in New Issue
Block a user