OpenTelemetry 面向贡献组织的营销指南

OpenTelemetry(简称 OTel)是终端用户、相邻的开源项目和最终销售基于 OTel 数据或组件构建的产品和服务的供应商之间的合作。和许多面向标准的项目一样,与 OTel 合作的供应商在市场上也是竞争对手,因此为贡献组织在 OTel 上的沟通和信息传递建立一些基本规则和期望非常重要。

事实上,OTel 的成功取决于众多参与方(包括供应商)之间真诚合作的实际情况和认知。在 OTel 内部有很多出色的技术工作正在进行,我们希望它不会被某些觊觎机会的营销部门所掩盖!

本文档分为两个部分:

  • 目标和指南: 我们想要实现什么?我们的指导是什么?
  • 担忧和后果: 我们如何确定违反了指南?我们该怎么办?

目标和指南

这些目标和指南有三个高层次的关注领域。

一:OpenTelemetry 是一项共同努力

  • 应该做的事情:
    • 根据 Linux 基金会的品牌和商标使用指南,使用项目素材,如标志和名称。
    • 强调 OTel 之所以存在要归功于合作众多的贡献者,他们来自竞争对手的供应商和提供商。
    • 引用与 OTel 工作相关的其他贡献者和供应商的名称。
    • 强调作为一个社区我们的共同目标是改进最终用户/开发者的体验,以及赋予他们权力。
  • 不应该做的事情:
    • 暗示某个单一提供商对于 OTel 本身和/或其各个组成部分负有责任。
    • 贬低其他组织或个人的贡献。

二:这不是竞争

  • 应该做的事情:
    • 强调所有的贡献都是有价值的,贡献有多种形式和规模,包括:
    • 对核心项目代码或语言/框架特定的 SDK 的贡献。
    • 创建和共享教育资源(视频、研讨会、文章)或可用于教育目的的共享资源(例如,使用特定语言/框架的示例应用程序)。
    • 组织活动或聚会小组等建设社区的活动。
    • 公开感谢其他组织对 OTel 的贡献。
  • 不应该做的事情:
    • 直接比较不同贡献者对 OTel 的数量或价值(例如,通过 CNCF devstats)。
    • 暗示偶尔或轻微贡献给 OTel 的贡献者一定是二流的,或者由于这些贡献者对 OTel 的兼容性应受到质疑(事实上,任何供应商都不需要为了支持 OTel 而贡献)。

三:提升 OTel 可互操作性和模块化的意识

  • 应该做的事情:
    • “高声讲述”OTel 的兼容性 - 越多的终端用户了解他们可以用 OTel 数据做什么,越好。
    • 强调任何 OTel 集成的供应商中立性和可移植性。
  • 不应该做的事情:
    • 暗示除非终端用户使用了 OTel 中的某些特定组件,否则他们不属于“使用了 OTel”(OTel 是一个具有许多解耦组件的“广泛”项目)。
    • 公开诋毁另一个供应商对于 OTel 的支持,尤其是没有客观证据的情况下。

担忧和后果

不可避免地会出现供应商(或至少他们的营销部门)违反这些指南的情况。迄今为止,这种情况并不频繁,因此我们不希望为处理这些问题而创建一个过于复杂的流程。

我们处理此类情况的方式如下:

  1. 发现相关的公开(营销)内容的人应该发送电子邮件至cncf-opentelemetry-governance@lists.cncf.io,并解释为何内容有问题,最好引用上述相关指南
  2. OTel 治理委员会(GC)将在其下一次(每周)会议上或通过电子邮件异步讨论该案例。OTel GC 将在初次报告后的两周内通过电子邮件做出回应
  3. 如果 GC 认为存在问题,将向有关内容的作者推荐一项纠正措施,并要求发布内容的组织将相关的员工培训以进一步预防类似问题。

如果某个特定供应商出现了问题的模式,GC 将召开会议讨论更重大的后果-例如,将该供应商的名称从 OTel 维护的兼容供应商列表中删除,或者仅仅公开记录该供应商的恶劣社区行为模式。

最后修改 December 10, 2023: translate (a4350d6e)