コンテンツの執筆と保守の方針

出典に基づく独自のレッスン

このサイト向けにレッスンを執筆しています。技術標準、研究、製品の動作には、一次資料を使います。出典のリンクから、証拠とその限界を確認できます。

研究結果と実践上の推奨を区別します。研究は、参加者、タスク、調査期間を示します。あらゆる状況に共通する生産性の結果を確定するものではありません。

例と計算は、判断を説明するためのものです。顧客の成果、サプライヤーの見積もり、予測ではありません。演習の完了は、個人や組織の認証にはなりません。

これらのページの執筆、翻訳、改訂にはAIを使っています。資料は、Taigaの豊富な社内知識ライブラリーと、信頼できる公開情報源を組み合わせています。自社の製品ドキュメント、エンジニアリングの実践、会社の知識も含みます。

AIには、独自の言語スタックで指示を与えます。用語、語調、構成、言語に関する詳細なルールです。開発者、マネージャー、技術リーダー、経営幹部に合わせて、これらのルールを大幅に調整しています。目的は、水増し、反復表現、根拠のない主張を避け、明確で役立つ内容を作ることです。

技術上の主張を、出典資料と現在の製品ドキュメントに照らして確認します。自動チェックで、リンク、構造、翻訳の網羅性を検証します。

これらの確認にも限界があります。テストの成功は、すべての説明が正しいことを証明しません。レビュー日は、レッスンを最後に確認した日を示します。法的・規制上の影響を伴う判断の前には、現在の一次資料を確認してください。

英語がマスター言語です。英語は、ASD-STE100 Simplified Technical Englishのスタイルで書きます。短い文、能動態、一貫した技術用語を使います。これは編集上の方針であり、標準全体への適合認証を受けたという主張ではありません。

翻訳にもAIを使い、レビュー済みの最新の言語別skillsを参照します。Skillsは、用語、語調、自然な表現を導くための指針です。意味、例、技術上の詳細を保つため、翻訳を英語マスターと照合します。

各翻訳は、安定したレッスン識別子とソースリビジョンを共有します。コンテンツチェックは、翻訳の欠落やカリキュラムのメタデータの不整合を拒否します。意味のレビューでは、各言語版が同じ概念を教えていることを確認します。

Taigaのレッスンは、現在の公開ドキュメントと、確認済みの製品動作を使います。該当する操作を見つけられるよう、製品内のラベルは変えません。利用できる操作は、権限とproductの設定によって変わる場合があります。

コンテンツの変更は、Gitによるレビューと公開チェックを通します。マスターレッスンが変わると、公開済みの翻訳も更新します。マーケティング上の主張や非公開の顧客情報を、レッスンの事実にはしません。