confluence

name	confluence
description	Confluence team documentation platform. Use for documentation.

Confluence

Confluence is the wiki for Jira users. It excels at structured documentation and deep Jira integration (embedding live Jira tables).

When to Use

• Enterprise Docs: HR policies, Engineering Standards.
• Jira Reports: Pages that pull in Jira data dynamically.
• Whiteboards: Visual collaboration capabilities (competing with Miro).

Core Concepts

Spaces

Containers for pages (e.g. "Engineering", "Marketing").

Page Tree

Hierarchical organization of pages.

Macros

Dynamic content ({jira}, {code}, {toc}).

Best Practices (2025)

Do:

• Use "Page Properties": Metadata for pages that can be queried in a "Page Properties Report".
• Use Templates: Standardize "Post Mortem" or "RFC" docs.
• Comment Inline: Highlight text to comment contextually.

Don't:

• Don't let it rot: Assign "Owners" to pages to ensure freshness.

References

• Confluence Documentation