製品のクレームは検査可能な動作に従う
ドキュメントは、パブリック API 契約およびこのリポジトリで表されるアプリケーションの動作と照合してチェックされます。機能の主張は、読者が検証できる範囲に限定されます。
技術情報源は一次的です
ガイドは、ベンダーの公式ドキュメント、仕様、およびファーストパーティのリファレンスを優先します。比較ページには出典とレビュー日が記載されているため、時間に敏感な主張を再確認できます。
SQL の例には宣言されたテスト境界があります
公開されたレシピは読み取り専用で、型指定されたイベント コントラクトが含まれています。自動チェックでは、文書化された DataFusion バージョンに対して SQL を計画します。合成結果の行は個別にレビューされます。
証拠は解釈から分離されている
合成設備が顧客のベンチマークになることはありません。顧客指標は、顧客が測定値、時間枠、帰属、正確な表現を承認した後にのみ公開されます。
日付は実質的なレビューを表します
ページの更新日は、その主張、例、出典、または重要なガイダンスが検討され、変更されると変更されます。変更されていないコンテンツを最新のものに見せるためだけに日付が更新されるわけではありません。
所有権
責任ある組織、明確なレビュー境界
表示される署名欄と構造化データにより、Telemetry 編集チームが組織作成者として、Telemetry 製品チームが技術レビュー担当者として識別されます。個々の投稿者の名前は、その人が公開プロフィールに同意した場合にのみ追加されます。個人の署名が示されていない場合でも、組織は責任を負い続けます。
公開コンポーネントは、同意、役割、関連する経験、および説明責任のあるプロファイル URL が記録されると、個人レベルの構造化データを含む名前付きの作成者およびレビューアーのプロファイルをサポートします。プレースホルダのアイデンティティ、生成された経歴、および個人の従業員の詳細は、署名欄を埋めるために公開されることはありません。
レビューは、クエリがすべてのビジネス定義に対して正しいことを意味するわけではありません。イベント名、アイデンティティ ルール、時間枠、しきい値、価格、およびインシデント ポリシーは、引き続き実装チームの選択肢となります。レシピでは、それらの決定を洗練されたチャートに隠すのではなく、エッジケースとして呼び出します。
生成された支援は、コンテンツの下書きやチェックに役立つ可能性がありますが、作成者または証拠源としてはリストされません。公開可能なページには依然として人間の所有権、有効な内部参照、主張が変更される可能性のあるソース レビュー、およびリポジトリの自動コンテンツ チェックが必要です。
名前付き貢献者ゲート
個人レベルの署名またはレビュークレジットの要件
- 公開名、役割、プロフィール、署名欄への同意
- 関連する経験と範囲を含む、このサイトが所有するプロフィール URL
- 特定のコンテンツタイプに対するレビュー責任の記録
- 承認日と修正、削除、役割変更のプロセス
レビュー担当者は、公開証拠テンプレートを使用して、個人レベルのプロファイルが寄稿者レジストリに追加される前に、範囲、一次情報源、修正、同意、および承認を記録できます。
貢献者テンプレートを開く請求前の証拠
隙間を埋めるための公共の取水路があれば、それを埋めることができるという証拠がある
承認の証拠が不足している場合、サイトは空の請求登録を保持します。これらのパスは、証拠を推定値、匿名帰属、またはロードマップ言語に置き換えるのではなく、必要なフィールドと現在の公開境界を公開します。
再現性の境界を検査する
SQL 方法論は、自動化された計画、ブラウザーのフィクスチャ、決定論的な出力、および依然として人間によるレビューが必要な決定について説明しています。