博客

OpenTelemetry 博客用于发布新特性、社区报告以及对 OpenTelemetry
社区（包括终端用户和开发者）有意义的任何新闻。所有人都可以撰写博客文章，请阅读下文了解相关要求。

文档还是博客文章？ {#documentation-or-blog-post}

在撰写博客文章前，请先思考你的内容是否也适合作为文档的一部分。如果答案是“是”，请通过创建一个 Issue 或拉取请求（PR）来提交你的内容，以将其添加到官方文档中。

请注意，OpenTelemetry 网站的维护者和审批者的重点是改进项目文档，因此博客文章的审查优先级会相对较低。

提交博客文章前的准备工作 {#before-submitting-a-blog-post}

博客文章不应具有商业性质，且应为原创内容，适用于整个 OpenTelemetry 社区。
博客文章应遵循社交媒体指南中的政策。

请确认你的内容在 OpenTelemetry 社区中具有广泛适用性。合适的内容包括：

• OpenTelemetry 新特性
• OpenTelemetry 项目更新
• 特别兴趣小组（SIG）的更新
• 教程和演示
• OpenTelemetry 集成介绍

不合适的内容包括：

• 推销某个厂商的产品

如果你的博客文章属于上述合适内容，
请创建一个 Issue，并包含以下信息：

• 博客文章标题
• 简短描述和文章大纲
• 如适用，请列出文中使用的技术。请确保这些技术均为开源，并优先使用 CNCF 项目而非
  CNCF 之外的项目（例如使用 Jaeger 进行链路追踪可视化，使用 Prometheus 进行指标可视化）
• 与文章相关的 SIG 名称
• 来自该 SIG 的一位赞助人（维护者或审批者）姓名，他/她将协助审查 PR。理想情况下，该赞助人应来自不同公司。

SIG Communication 的维护者会验证你的博客文章是否满足所有接受条件。如果你在最初的
Issue 中没有指定 SIG/赞助人，他们也会引导你找到合适的 SIG 联系以获得支持。
拥有赞助人不是强制性的，但能提高文章被更快审查和批准的机会。

如果 Issue 中的信息完整，维护者将确认你可以提交博客文章。

提交博客文章 {#submit-a-blog-post}

你可以通过 fork 本仓库并在本地撰写文章，或使用 GitHub UI 提交文章。无论采用哪种方式，
都请遵循博客文章模板中的说明。

Fork 仓库并在本地撰写 {#fork-and-write-locally}

在完成本地 Fork 设置后，你可以使用模板创建博客文章。按以下步骤操作：

1. 在仓库根目录运行以下命令：

   npx hugo new content/en/blog/2024/short-name-for-post.md
   

   如果文章包含图片或其他资源，请运行以下命令：

   npx hugo new content/en/blog/2024/short-name-for-post/index.md
   

2. 编辑上一步所创建路径下的 Markdown 文件。该文件基于
   archetypes
   中的博客文章模板初始化。

3. 将资源（如图片或其他文件）放入你创建的文件夹中。

4. 当文章准备就绪后，通过 PR 提交。

使用 GitHub UI {#use-the-github-ui}

如果你不想在本地 Fork 仓库，也可以通过 GitHub UI 添加文章。请按以下步骤操作：

1. 打开博客文章模板，
   点击右上角的 Copy raw content 复制原始内容。

2. 选择创建新文件。

3. 将第一步中复制的内容粘贴到新文件中。

4. 为你的文件命名，例如：
   content/en/blog/2022/short-name-for-your-blog-post/index.md

5. 在 GitHub 上编辑 Markdown 文件。

6. 当文章准备就绪，点击 Propose changes 并按照指引提交。

发布时间安排 {#publication-timelines}

OpenTelemetry 博客没有固定的发布时间安排，这意味着：

• 你的文章将在获得要求的所有审批后发布。
• 如果有需要，发布可以延期，但维护者无法保证在某个特定时间前完成发布。
• 某些博客文章（如重大公告）将具有更高优先级，可能会在你的文章之前发布。