tech

Rawkode Academy 技术档案

在 content/technologies 中维护准确、聚焦的技术档案。

编写前

1. 检查 content/technologies/<kebab-case-slug>/index.mdx 是否存在。
2. 阅读 content/src/technologies.ts 和 content/src/dimensions.ts，以当前架构为准；然后阅读附近的技术档案，了解本地 frontmatter 和行文惯例。
3. 仅从项目的主要来源进行研究：官方网站、文档、源代码仓库和官方许可信息。

当前线上架构要求提供 name 和 website；省略 license 和 status 时会使用默认值。只有在经过核实且确有用处时，才添加可选字段：seo、logos、source、documentation、category、subcategory、aliases、relatedTechnologies、terms、cncf、community、useCases、features、learningResources 和 matrix。

档案规则

• logos 仅用布尔值记录现有本地资源：icon、horizontal 和 stacked 分别表示 icon.svg、horizontal.svg 和 stacked.svg 是否存在。该字段为可选；切勿凭空编造、在没有来源证明的情况下下载，或创建占位资源。
• 使用一个可选的单值 category 和一个可选的单值 subcategory；不要使用 categories。
• 生命周期 status 仅可使用：alpha、beta、stable、preview、superseded、deprecated 或 abandoned。
• 如果添加 matrix，其必填字段 status 只能是 skip、watch、explore、learn、adopt、advocate、graveyard 或 guilty-pleasure。其可选字段 grouping、confidence 和 trajectory 分别使用 plumbing／platform／observability／security、gut／some-experience／deep-experience，以及 rising／stable／falling。
• 不要添加过时的 frontmatter，例如顶层 description、categories 或 radar 块。

新建或更新

新建档案时，仅创建所需目录、index.mdx 和经过核实的徽标文件。根据来源编写简洁、客观的 MDX。更新现有档案时，先核实其元数据、术语、链接和陈述，再进行能解决请求的最小修改。保留有用的现有内容，并遵循附近既定的风格。

注意事项

• 优先采用主要来源，并区分已核实的事实与不确定的说法。
• 不要编造元数据、URL、功能、关联关系或资源来源。
• 将修改限定在请求涉及的技术范围内；避免大范围重写和修改无关文件。
• 报告已核实、已更改和未解决的内容。