confluence

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Confluence

Confluence

Confluence is the wiki for Jira users. It excels at structured documentation and deep Jira integration (embedding live Jira tables).
Confluence是面向Jira用户的wiki工具,擅长结构化文档编制以及与Jira的深度集成(可嵌入实时Jira表格)。

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).
  • 企业文档:HR政策、工程标准等。
  • Jira报告:可动态拉取Jira数据的页面。
  • 白板协作:具备可视化协作能力(可与Miro媲美)。

Core Concepts

核心概念

Spaces

空间(Spaces)

Containers for pages (e.g. "Engineering", "Marketing").
页面的容器(例如“工程”、“营销”空间)。

Page Tree

页面树(Page Tree)

Hierarchical organization of pages.
页面的层级化组织结构。

Macros

宏(Macros)

Dynamic content (
{jira}
,
{code}
,
{toc}
).
动态内容(如
{jira}
{code}
{toc}
)。

Best Practices (2025)

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.
建议做法
  • 使用“页面属性”:为页面添加元数据,以便在“页面属性报告”中进行查询。
  • 使用模板:标准化“事后复盘”或“请求评论(RFC)”类文档。
  • 内联评论:高亮文本以添加上下文相关的评论。
避免做法
  • 不要让文档过时:为页面分配“负责人”以确保内容的时效性。

References

参考资料