Skip to content

Commit c1a64a9

Browse files
committed
feat: Add draft filter and documentation for CMS workflow
- Add "Drafts" view filter to CMS config for filtering draft resources - Document draft behavior: drafts appear in all topics until merged - Explain that this is normal CMS behavior to help find drafts - Add draft workflow steps in both EN and FR documentation - Clarify that published resources only appear in correct topic
1 parent e22c314 commit c1a64a9

File tree

2 files changed

+31
-0
lines changed

2 files changed

+31
-0
lines changed

DECAP-CMS-SETUP.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,20 @@ The CMS uses an **editorial workflow** with pull requests for content review:
158158
6. **Further edits** will update the same PR branch
159159
7. **Merge PR in GitHub** to publish changes
160160

161+
### Working with Drafts
162+
163+
**Understanding Draft Behavior:**
164+
165+
- **Drafts appear in all topic views**: When a resource is in draft status (not yet merged), it will appear at the top of **every topic filter** in the CMS UI with a "Draft" label. This is normal behavior and helps you find your drafts regardless of which filter you're using.
166+
- **Filter drafts only**: Use the **"Drafts" filter** at the top of the view filters to see only your draft resources
167+
- **After merging**: Once you merge the PR, the resource becomes published and will only appear under its assigned topic
168+
169+
**Draft Workflow:**
170+
1. Create new resource → Automatically starts as draft
171+
2. Edit and save → Remains in draft status
172+
3. Set status to "In review" → Creates PR, still shows as draft in CMS
173+
4. Merge PR in GitHub → Draft becomes published, appears only in correct topic
174+
161175
### Understanding Language Availability
162176

163177
- **both** (default): Resource appears on both EN and FR pages without language indicator
@@ -457,6 +471,20 @@ Le CMS utilise un **flux de travail éditorial** avec des demandes de tirage (pu
457471
6. **D'autres modifications** mettront à jour la même branche PR
458472
7. **Fusionnez la PR dans GitHub** pour publier les modifications
459473

474+
### Travailler avec les brouillons
475+
476+
**Comprendre le comportement des brouillons :**
477+
478+
- **Les brouillons apparaissent dans toutes les vues de sujet** : Lorsqu'une ressource est en statut de brouillon (pas encore fusionnée), elle apparaîtra en haut de **chaque filtre de sujet** dans l'interface du CMS avec une étiquette "Draft". C'est un comportement normal qui vous aide à trouver vos brouillons quel que soit le filtre que vous utilisez.
479+
- **Filtrer uniquement les brouillons** : Utilisez le filtre **"Drafts"** en haut des filtres de vue pour voir uniquement vos ressources en brouillon
480+
- **Après fusion** : Une fois que vous fusionnez la PR, la ressource devient publiée et n'apparaîtra que sous son sujet assigné
481+
482+
**Flux de travail des brouillons :**
483+
1. Créer une nouvelle ressource → Commence automatiquement comme brouillon
484+
2. Modifier et enregistrer → Reste en statut de brouillon
485+
3. Définir le statut sur "In review" → Crée une PR, s'affiche toujours comme brouillon dans le CMS
486+
4. Fusionner la PR dans GitHub → Le brouillon devient publié, apparaît uniquement dans le bon sujet
487+
460488
### Comprendre la disponibilité linguistique
461489

462490
- **both** (par défaut) : La ressource apparaît sur les pages EN et FR sans indicateur de langue

src/admin/config.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,9 @@ collections:
3636
create: true
3737
slug: "{{slug}}"
3838
view_filters:
39+
- label: "Drafts"
40+
field: draft
41+
pattern: true
3942
- label: "Accessible meetings and events"
4043
field: topic
4144
pattern: "Accessible meetings and events"

0 commit comments

Comments
 (0)