tech

Rawkode Academy テクノロジープロファイル

content/technologies に正確で焦点を絞ったプロファイルを維持します。

作成前の確認事項

1. content/technologies/<kebab-case-slug>/index.mdx が存在するかどうかを確認します。
2. 現在のスキーマの権威として content/src/technologies.ts と content/src/dimensions.ts を読み、次に近隣のテクノロジープロファイルを読んで、ローカルのフロントマターと文章の慣例を確認します。
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 を 1 つと、オプションの単数形 subcategory を 1 つ使用してください。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 を使用します。
• トップレベルの description、categories、radar ブロックなどの廃止されたフロントマターを追加しないでください。

作成または更新

新しいプロファイルの場合、必要なディレクトリ、index.mdx、検証済みのロゴファイルのみを作成します。情報源に基づいた、簡潔で客観的な MDX を記述します。既存のプロファイルの場合、まずそのメタデータ、用語、リンク、主張を検証し、次にリクエストを解決する最小限の修正を行います。有用な既存のコンテンツと、確立された近隣のスタイルを保持します。

ガードレール

• 一次情報源を優先し、検証済みの事実と不確実な主張を区別します。
• メタデータ、URL、機能、関係、アセットの出所を捏造しないでください。
• 変更は要求されたテクノロジーに限定し、広範な書き換えや無関係なファイルを避けます。
• 何を検証し、何を変更し、何が未解決のまま残ったかを報告します。