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