G1Joshi 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.