訂正

FPGA Guideの誤りを報告する方法、報告後に起こること、そして行った訂正の公開記録。

誤りは起こるものであり、毎日公開するサイトでは一度ならず起こります。このページでは、報告の方法、当サイトの対応、記録の保管場所を説明します。

誤りの報告方法

お問い合わせのページから編集者にメールしてください。ページのアドレス、何が間違っているか、可能であれば何が正しいかとその確認先を含めてください。データシート、ユーザーガイド、規格へのリンクが、修正への最も速い道です。

確信がなくても構いません。「これは間違っているように見える」という報告も有用です。当サイトで確認します。

その後の流れ

手順 時期
仕分け: 報告を読み、訂正、更新、見解の相違のいずれかを判断する 数日以内
修正: ページを変更し、「更新日」を進める 正しい答えを確認でき次第
注記: ページ下部に日付付きの一行で何を変更したかを記す 修正と同時
記録: このページの公開記録に訂正を追加する 修正と同時

報告が誤りだと判明した場合は、出典を添えてその理由を返信します。判断できない場合は、判断できるまでページに係争中の印を付けます。

メールで届いた報告には、受領時ではなく解決時に返信します。1週間音沙汰がなくても、それはまだ確認中ということであり、報告が無視されたわけではありません。

訂正と更新の違い

訂正は、公開時点で間違っていたものに対する変更です。誤った数値、誤った部品名、本文の説明どおりに動かなかったコード、引用した出典に裏付けられない主張などです。訂正はページに日付付きの注記が付き、下の記録に項目が追加されます。

更新は、公開時には正しかったがそうでなくなったものに対する変更です。新しいツールバージョン、改名された製品、生産終了したボード、移動したリンクなどです。更新は「更新日」を進め、リファレンスページでは「最終確認日」も進めます。記録には項目を追加しません。古い内容が誤りではなかったからです。

同期リセットが非同期リセットより優れているかどうかといった見解の問題は、どちらでもありません。議論に価値があれば、ページに反論を追加することがあります。

「最終確認日」の慣例

すべてのリファレンスページには2つの日付が表示されます。「更新日」はコンテンツが最後に変更された日です。「最終確認日」は、ページ上のバージョン、デバイス一覧、価格、リンクがまだ最新であることを人または自動チェックが最後に確認した日です。ページは確認されずに更新されることも(誤字の修正)、更新されずに確認されることも(すべて問題なし)あります。

週次のジョブが最も変わりやすい事実を再確認し、合格すれば日付を進めます。チェックに失敗した場合、人が確認するまでページに古い可能性あり(stale)の印を付けます。この日付は、ページをどの程度信頼するかを自分で判断するためのものです。

訂正記録

各項目には日付、ページ、何が間違っていて何を変更したかの一行の説明を記します。項目は恒久的にここに残ります。

記録は空から始まります。FPGA Guideは2026年11月13日に公開され、まだ訂正は記録されていません。最初の誤りが修正されたとき、最初の項目がここに現れます。