OpenAPI 博客指南

OpenAPI 博客是 OpenAPI Initiative 和 OAS（OpenAPI 规范）成员和社区向更广泛的受众宣传其工作和参与如何为他们创造机遇的渠道。是否接受博客文章由 OpenAPI Initiative 拥有最终决定权。

这可能包括领先机构、公司和开发者如何使用、开发和推进 API 的摘要。我们正在寻找来自各种规模和形式的公司和开发者的成功和失败、尝试和完成的故事。

我们发布技术和非技术内容。鼓励参与 API 开发、维护、分发和使用的人员为博客做出贡献。产品经理、业务发展经理和各种类型的作家都受欢迎。

我们正在寻找来自 API 社区的客座博主，他们希望分享他们的工作和经验。认识到我们都从彼此的故事中学习，我们希望构建一个可以帮助更广泛的 API 社区的这些故事的组合。

请随时撰写有关 API 相关会议（包括 ASC 2021）、会议、全球本地用户组、新的 API 认证和培训工作组或计划的文章。同样，我们也希望听到您如何在公司中实施（或尝试实施）API 标准、帮助定义 API 策略、与合作伙伴合作进行 API 集成以及来自边缘的任何其他故事。

质量、归属和许可

我们正在寻找能够教导并为我们的社区提供价值的文章。博客应该认识到标准化 API 描述方式的巨大价值，以及 OpenAPI Initiative 如何支持全球 API 用户、维护者和开发人员社区。

客座文章必须是供应商中立的，尽管它们可能提及参与特定部署或采用路径的供应商、他们举办的面对面活动或在活动中的发言，或其他表明其在社区中积极参与的迹象。但它不应该感觉像是对您的产品、服务或公司的广告。

您的文章必须是您自己的内容，但可以在互联网上的其他地方发布，前提是得到该网站的许可。所有内容应包含署名并根据知识共享署名许可发布。欢迎您在自己的博客上重新发布。

最有趣的文章是那些教导或展示以可能其他人从未想过的方式做事的方法。优秀的博客文章会展示遇到的障碍并解释如何克服这些障碍（而不是一切都像彩虹和独角兽一样）。当向他人展示解决问题的方案时，请链接回 GitHub 问题，以便读者可以跟踪。

有趣而鼓舞人心！

行为准则

我们不回避批判性评论或广泛问题，但会以敏感、专业和谨慎的方式来处理这些问题，以使社区受益并对社区产生积极影响。根据我们的行为准则，我们承诺让所有人都能毫无阻碍地参与我们的项目和社区，无论年龄、体型、残疾、种族、性别认同和表达、经验水平、教育程度、社会经济地位、国籍、个人外貌、种族、宗教或性取向。如果您想了解更多有关我们行为准则的信息，请点击这里。

推广

您的博客将在 OpenAPI 的 Twitter 频道（@openapispec 和 @apispecs）和 LinkedIn 上分享。请随意转发或分享。别忘了在您自己的社交频道和最喜欢的新闻聚合网站上分享您的作品。建议网站：Twitter、LinkedIn、Reddit、Hacker News、DZone、TechBeacon、CodeProject。

如何提交以供考虑

请将博客文章或简要摘要以及文章主题提交至 [email protected]，主题行：“Proposed Blog: BLOG TITLE”，以供考虑。公关团队将及时审查您的提交并提供继续撰写整篇文章或提供有关下一步操作的反馈的绿色信号。

如果您提交的是已存在的文章或演示文稿，请将完整内容发送给我们，并附上内容所有者的明确许可说明。

您的提交被批准后，将被添加到我们的博客发布日历中，并将提供发布日期，以便您相应地通过个人和公司社交媒体渠道进行推广。

博客文章的字数一般不应超过 1000 字，也不应少于 300 字。强烈建议使用图表、代码示例或照片。