Nom et Clé d’un Espace

Documentation Atlassian :

• Data Center
• Cloud

Des règles de nommage vont  rapidement devenir obligatoires avec la multiplication des espaces dans votre organisation :

• Utiliser peu ou pas de caractères spéciaux dans les noms d’espace. Cela n’est pas utile et va complexifier la recherche et l’accès au contenu de chaque espace.
• Définir une clé de l’espace simple : si un espace Confluence est lié à un projet Jira, l’utilisation de la même clé d’espace et de projet Jira serait intéressant pour faciliter les accès et la mémorisation.
• Utiliser et définir des catégories d’espaces pour catégoriser et trier ces espaces et faciliter leur accès et recherche.
• Définir des règles de nommages des noms et clés d’espaces par type, par nom de projet ou d’équipe est important :
  • utiliser des préfixes par type, par exemple :
    • EQP pour équipe,
    • PRJ pour les projet,
    • CLI pour les projets clients,
    • INT pour l’intranet d’entreprise
  • suivi d’un nom parlant et explicite :
    • MARKETING pour l’équipe en question
    • IDALKO pour le nom d’un client
    • le code projet ou la référence projet
  • un nom explicite et clair exprimant le contenu de l’espace si nécessaire
  • un exemple pour un espace client :
    • nom de l’espace : CLI – iDalko – Atlassian JIRA CONFLUENCE
    • clé de l’espace : CLIIDALKOATL par exemple

répertoire des espaces

Gestion d’un espace

Documentation Atlassian : 

• Data Center
• Cloud

Ranger et réorganiser régulièrement vos espaces jusqu’à trouver la meilleure structure adaptée à la taille actuelle de l’espace, qui va continuer de se remplir en page et contenu. En respectant quelques règles, déplacer du contenu n’est pas un problème tant que vos pages racines sont dynamiques et mise à jour si nécessaire :

• Identifier les personnes qui aideront à ranger, trier,organiser les espaces et leur contenu régulièrement (1 à 2 fois par mois selon les usages).
• Une page d’accueil d’espace dynamique composée en grande partie de macros contenu pour l’accès à ce dernier, ainsi même si le contenu est déplacé, l’accès à ce contenu est toujours garanti.
• Hiérarchiser les pages et leur contenu : trier, ranger le contenu par hiérarchie permet ainsi d’avoir plusieurs pages racines, par sujet de contenu.
• Définir une hiérarchie par défaut si nécessaire par type d’espace : cela aidera chaque collaborateur à accéder au contenu des espaces, selon son type, la hiérarchie et l’organisation sera la même.

exemple de page d’accueil d’un espace

Étiquettes (ou labels)

Documentation Atlassian : 

• Data Center
• Cloud

Les étiquettes utilisées dans Confluence sont globales à toute l’instance, de la même manière que les noms d’espaces, il est important de définir des règles de nommage pour maintenir une cohérence, faciliter l’accès au contenu et l’organisation générale partagée à travers toutes vos équipes :

• De base dans Confluence, toutes les étiquettes sont composées par caractère minuscule uniquement.
• Identifier un séparateur pour toutes vos étiquettes : par exemple le « – » ou « _ »en général le tiret simple est le plus utilisé.
• Gérer les étiquettes et connaître les plus utilisés :
  • liste des étiquettes utilisé sur un espace : URL DE BASE CONFLUENCE /labels/listlabels-alphaview.action?key=CLE DE L’ESPACE
  • liste de toutes les étiquettes utilisées sur tous les espaces : URL DE BASE CONFLUENCE /labels/listlabels-alphaview.action
  • liste des étiquettes les plus populaire sur tous les espaces : URL DE BASE CONFLUENCE /labels/listlabels-heatmap.action

toutes les étiquettes d’une instance Confluence

Pages d’un espace

Documentation Atlassian : 

• Data Center
• Cloud

Les pages sont utilisées pour la documentation de projet, d’équipe, de processus d’activité, de bases de connaissances et tout autre type de documentation nécessaire au fonctionnement d’un projet, de la société ou d’une équipe. Afin de faciliter l’organisation d’un espace, nous vous invitons à suivre les  quelques règles liées aux pages ci-dessous :

• Hiérarchisation des pages obligatoires, avec structure et organisation du contenu,
• Proposer une hiérarchie de base pour les espaces en fonction de leur type, ainsi les utilisateurs retrouveront la même hiérarchie partout en fonction du type d’espace,
• Ne pas avoir trop de niveau hiérarchique : 5 niveaux restent maintenables, au delà cela peut devenir compliqué à maintenir et n’aidera pas l’accès au contenu,
• Utiliser les modèles de page au maximum pour partager la structure d’une page,
• Utiliser les étiquettes de pages pour trier et organiser vos pages par sujet,
• Nommer vos pages avec des noms explicites, en limitant les caractères spéciaux dans le nom des pages,
• Ne pas créer de page vide, toujours créer une page avec un minimum de contenu pour ne pas frustrer vos utilisateurs.
• Éviter de créer des pages trop longues et trop riches en contenu, découper une grosse page en un ensemble de pages plus petites vous permettra de mieux réutiliser le contenu et ainsi éviter les duplications de contenu.

exemple d’arborescence de page pour un espace de type Produit

Les macros incontournables

Documentation Atlassian : 

• Data Center
• Cloud

L’utilisation des macros dans Confluence va vous permettre d’étendre les capacités de vos pages Confluence vous autorisant à ajouter des fonctionnalités étendues et du contenu dynamique. Nous allons lister ici les macros les plus utilisés pour créer des pages dynamiques basées sur le contenu et sur le contenant.

• Include Page Macro – Inclure page : la plus pratique de macros pour éviter la duplication de contenu, cela permet d’afficher le contenu d’une page dans une autre page.
• Attachments Macro – Pièces jointes : permet à la fois d’ajouter des pièces jointes sur une page par glisser / déposer mais aussi de lister (et filtrer) les pièces jointes d’une page.
• Excerpt Macro – Extrait : permet d’ajouter un extrait de contenu à une page, visible ensuite dans pleins d’autres macros de contenu.
• Related Labels Macro – Étiquettes associées : permet d’afficher les étiquettes associées à une ou plusieurs autres étiquettes de contenu.
• Labels List Macro – Liste d’étiquettes : liste des étiquettes d’un espace
• Recently Used Labels Macro – Étiquettes récemment utilisées : liste les étiquettes récemment utilisées dans un espace.
• Content by Label Macro – Contenu par étiquette : affiche des pages portant le ou les étiquettes mentionnées.
• Content by User Macro – Contenu par utilisateur : affiche le contenu rédigé par un utilisateur
• Content Report Table Macro – Rapport de contenu : permet de lister les pages portant une ou plusieurs étiquettes.
• Create from Template Macro – Créer à partir d’un modèle : affiche un bouton de création de page via un modèle.
• Table of Contents Macro – Sommaire : affiche de manière dynamique le sommaire d’une page (en utilisant les différents formats de titre utilisé sur une page).
• Children Display Macro – Affichage enfants : affiche toutes les pages enfants de la page sur laquelle la macro est utilisée.
• Page Tree Macro – Arborescence des pages : permet d’afficher une arborescence de pages.
• Page Tree Search Macro – Recherche de l’arborescence de pages : permet de recherche dans l’arborescence de pages.

toutes les macros Confluence