这些指南涵盖了 Kubernetes 主博客和 Kubernetes 贡献者博客。
所有博客内容还必须遵循内容指南中的总体政策。
确保你熟悉为 Kubernetes 博客贡献内容的介绍部分,不仅是为了了解两个官方博客及其之间的区别,也是为了对整个过程有一个概览。
Kubernetes 项目仅接受原创内容,且必须为英文。
如果内容已经提交或在 Kubernetes 项目之外发布,Kubernetes 项目则不能接受该内容用于博客。
官方博客不作为第三方重新利用已有内容并将其作为新内容发布的媒介。
这一限制甚至延伸至推广其他 Linux 基金会和 CNCF 项目。许多 CNCF 项目都有自己的博客。对于特定项目的帖子,这些博客通常是更好的选择,即使那个其他项目是专门为与 Kubernetes (或与 Linux 等)协同工作而设计的。
文章必须包含适用于整个 Kubernetes 社区的内容。例如,投稿应侧重于上游Kubernetes,而不是特定供应商的配置。对于提交到主博客且不是镜像文章的文章,文章中的超链接应通常指向官方 Kubernetes 文档。在进行外部引用时,链接应该是多样的 - 例如,投稿不应只包含返回单个公司博客的链接。
官方 Kubernetes 博客不是进行供应商宣传或推广 Kubernetes 外部特定解决方案的地方。
有时,这之间的平衡很微妙。你可以在 Slack (#sig-docs-blog)上询问某篇文章是否适合发布在 Kubernetes 博客和/或贡献者博客 - 不要犹豫,随时联系。
内容指南无条件适用于博客文章及其添加的 PR。请记住,指南中的一些限制仅与文档相关;那些标记的限制不适用于博客文章。
网站已被本地化为多种语言;英文是所有其他本地化的“上游”。即使你懂另一种语言并愿意提供本地化,这也应该是一个单独的 PR(参见每个 PR 的语言)。
你必须编写原创内容,并且你必须拥有将该内容授权给云原生计算基金会(Cloud Native Computing Foundation)的权限(这样 Kubernetes 项目才能合法发布它)。这意味着不仅直接抄袭是被禁止的,如果你没有权限满足 CNCF 版权许可条件(例如,如果你的雇主有关于知识产权的政策限制了你能做的事情),你也不能撰写博客文章。
license 允许将博客的内容用于商业目的,但反之则不然。
与参与 Kubernetes SIG 活动或其成果相关的主题总是合适的(参见贡献者通讯团队中的工作以获得这些帖子的支持)。
该项目通常会将这些文章镜像到两个博客上。
Kubernetes 网站拥有中国政府颁发的互联网内容提供者(ICP)许可证。Kubernetes 不能发布那些会被中国政府官方网络内容过滤系统阻止的文章(尽管这种情况不太可能发生)。
除了通用的风格指南外,博客文章应该(但不是必须)遵循博客特定风格建议。
本页面其余部分为附加指南;这些并不是文章必须遵守的严格规则,但如果文章明显不符合这里的建议,审稿人可能会(也应该)要求对文章进行编辑。
对于插图
—— 包括图表或图形—— 在可行的情况下,使用图形简码。你应该设置一个alt属性以提高可访问性。
使用矢量图像进行插图、技术图表和类似图形;强烈建议使用 SVG 格式。
使用光栅图像进行插图的文章更难以维护,在某些情况下,博客团队可能会要求作者在文章可以发布之前进行修改。
博客文章应力求面向未来:
以下是一些适合主 Kubernetes 博客的内容示例:
这里有一些适合 Kubernetes 贡献者博客的内容示例:
然而,项目不会发布: