Créer une page Wiki

Créez de nouvelles pages wiki pour documenter les connaissances, les processus et les spécifications techniques. Les pages peuvent être des documents de premier niveau ou des sous-pages imbriquées, supportant une organisation hiérarchique profonde pour des besoins de documentation complexes.

Créer une page racine

Les pages racines apparaissent au niveau supérieur de votre arborescence wiki.

Depuis la barre latérale

1. Cliquez sur le bouton "Créer une page" en haut de la barre latérale
2. La modale de création s'ouvre
3. Entrez le titre de la page dans le champ requis
4. Optionnellement, ajoutez du contenu initial
5. Cliquez sur Créer

Depuis l'état vide

Quand le wiki n'a pas de pages :

1. Voyez le message d'état vide
2. Cliquez sur "Créer votre première page"
3. Complétez la modale de création
4. Votre première page est prête

Créer une sous-page

Les sous-pages s'imbriquent sous les pages existantes, construisant une documentation hiérarchique.

Depuis l'arborescence des pages

1. Survolez la page parente dans l'arborescence de la barre latérale
2. Une icône "+" apparaît à droite
3. Cliquez sur l'icône "+"
4. La modale s'ouvre avec le contexte parent
5. Entrez le titre de la sous-page
6. Cliquez sur Créer

La nouvelle page s'imbrique sous le parent dans l'arborescence de navigation.

Contexte parent

Lors de la création d'une sous-page, la modale affiche :

• Titre de la page parente
• Indicateur visuel de l'imbrication
• Confirmation de la hiérarchie

Cela aide à confirmer que vous créez au bon emplacement.

Champs de la modale

Titre de la page (Requis)

Objectif : Le nom qui apparaît dans la navigation et comme titre de la page.

Directives :

• Descriptif et spécifique
• 3-100 caractères
• Évitez les caractères spéciaux qui peuvent causer des problèmes d'URL
• Utilisez des conventions de nommage cohérentes

Bons exemples :

• "Guide d'authentification API"
• "Déploiement en production"
• "Notes de rétrospective Sprint 23"

Évitez :

• Mots uniques comme "Notes" (trop générique)
• Titres très longs (tronqués dans la navigation)
• Dupliquer les noms de pages existantes

Contenu initial (Optionnel)

Objectif : Démarrer la page avec du contenu au lieu de vide.

Format : Texte brut ou formatage style Markdown.

Cas d'utilisation :

• Coller du contenu existant
• Partir d'un template
• Notes rapides à développer plus tard

Si laissé vide, la page se crée vide—vous pouvez ajouter du contenu en mode édition après la création.

Après la création

Navigation immédiate

Après avoir cliqué sur Créer :

1. La modale se ferme
2. La nouvelle page apparaît dans l'arborescence
3. Le contenu de la page se charge au centre
4. Vous pouvez immédiatement commencer à éditer

Vue page vide

Les nouvelles pages sans contenu initial affichent :

• Titre de la page comme en-tête
• Zone de contenu vide
• Bouton Éditer pour ajouter du contenu

Mode édition

Pour ajouter du contenu après création :

1. Cliquez sur "Éditer la page" dans la barre latérale droite
2. La page entre en mode édition
3. Ajoutez votre contenu
4. Cliquez sur Sauvegarder

Organisation des pages

Choisir l'emplacement

Avant de créer, décidez de la hiérarchie :

Page racine quand :

• Catégorie majeure de documentation
• Référence autonome
• Page index ou hub

Sous-page quand :

• Liée à une page existante
• Partie d'un sujet plus large
• Expansion détaillée du parent

Restructurer plus tard

Les pages peuvent être déplacées après création :

• Glisser-déposer dans l'arborescence (si activé)
• Éditer la page pour changer le parent
• Créer une nouvelle page et copier le contenu

Considérations de profondeur

Bien que l'imbrication illimitée soit supportée :

• 2-3 niveaux sont généralement suffisants
• L'imbrication profonde rend la navigation plus difficile
• Utilisez des liens croisés au lieu d'arborescences profondes

Templates

Créer des pages templates

Configurez des templates réutilisables :

1. Créez une page nommée "[Template] Notes de réunion"
2. Ajoutez la structure avec des espaces réservés
3. Quand nécessaire, copiez le contenu du template vers une nouvelle page

Suggestions de templates

Notes de réunion :

## Date : [DATE]
## Participants : 
- 

## Ordre du jour
1. 

## Discussion

## Décisions prises

## Actions à faire
- [ ] 

## Prochaine réunion :

Spécification technique :

## Vue d'ensemble

## Énoncé du problème

## Solution proposée

## Conception technique

## Changements API

## Changements base de données

## Stratégie de test

## Plan de déploiement

Runbook :

## Objectif

## Prérequis

## Étapes
1. 
2. 
3. 

## Vérification

## Rollback

## Escalade

Bonnes pratiques

Nommer de façon cohérente

Établissez des conventions d'équipe :

• "Comment..." pour les guides
• "[Composant] Architecture" pour les docs techniques
• "AAAA-MM-JJ Réunion" pour les notes

Commencer par la structure

Même avec le contenu initial vide :

• Planifiez vos titres
• Sachez quelles sections sont nécessaires
• Créez le plan d'abord

Lier à la création

Après la création :

• Liez depuis les pages connexes
• Ajoutez aux pages index
• Référencez dans les tâches pertinentes

Définir la propriété

Chaque page devrait avoir un propriétaire :

• Responsable des mises à jour
• Répond aux questions
• Révise périodiquement

Permissions

La création de page requiert les permissions appropriées :

Les paramètres du projet peuvent davantage restreindre la création.

Dépannage

Bouton créer désactivé :

• Le champ titre peut être vide
• Vérifiez les champs requis
• Vérifiez les permissions

La page n'apparaît pas dans l'arborescence :

• L'arborescence peut nécessiter un rafraîchissement
• Vérifiez les erreurs de création
• Essayez de naviguer ailleurs et revenir

Impossible de créer une sous-page :

• La page parente doit être valide
• Vérifiez les permissions
• Assurez-vous que le parent n'est pas archivé

Erreur titre déjà existant :

• Les noms de pages doivent être uniques dans le projet
• Ajoutez de la spécificité au titre
• Vérifiez s'il existe une page similaire

Raccourcis clavier