explain-webpage

HTML で説明する

Karpathy の前提：アイデアは、使い捨てのカスタムソフトウェアによって理解しやすくなることがあります。

1. 読者が抱いている主な疑問を見つけます。仕組みを具体的に示す例を 1 つ選びます。事実、前提、未確認事項を明確に区別します。
2. 完成した HTML ページを作成します。ユーザーがすでにアプリを持っている場合や、別のアセットが必要な場合を除き、CSS と JavaScript を埋め込んだ自己完結型の単一ファイルを優先します。
3. 学びにつながるインタラクションを追加します。入力値を変更する、手順を表示する、シナリオを比較する、仕組みを見るなどの方法があります。何が変わったのか、なぜ変わったのかを示します。装飾目的のコントロールは避けます。
4. 明確な階層、読みやすい文字、簡潔な説明を用います。コントロールにはラベルを付け、キーボードで操作できるようにし、フォーカスを視覚的に示します。画面幅が狭い場合や、動きを減らす設定にも対応します。
5. ページを開き、コントロールを操作して、画面幅が狭い場合も確認します。見た目だけでなく、例の内容も検証します。問題があれば修正し、開き方を簡潔に添えて HTML を返します。テストできなかったことがあれば明記します。

アニメーションを使って注目を促します。説明に必要な範囲で、ページをできるだけ小さく保ちます。ユーザーに求められない限り、公開しないでください。