Skip to content

docs: 画面付きの調査・回答例を追加 - #210

Open
tomtwinkle wants to merge 3 commits into
mainfrom
feature/scenario-research-examples
Open

tomtwinkle wants to merge 3 commits into
mainfrom
feature/scenario-research-examples

Conversation

@tomtwinkle

@tomtwinkle tomtwinkle commented Oct 13, 2026 •

Copy link
Copy Markdown
Collaborator

概要

既存の解答から、資料の読み方・解釈・次の疑問を具体的に振り返れるよう、30シナリオと1チュートリアルに画面付きの調査・回答例を追加します。全91設問から対応箇所へリンクし、69枚の実画面を掲載します。

Add illustrated investigation examples to 30 scenarios and one tutorial, showing how to read sources, interpret evidence, and form follow-up questions. Link all 91 questions to their examples and include 69 actual screenshots.

問題のテーマ

  • 問題本文とカテゴリREADMEを出発点に、読む箇所・適用条件・解釈・追加調査の動線を記録。仕様、実装、実測、未確認事項を区別します。
    Start from the problem and category README; explain what to read, applicable conditions, interpretations, and further investigation. Distinguish specifications, implementation, observations, and open questions.

  • 影響範囲は教材・案内文書とシナリオ構造検査です。カテゴリの調べ方案内と回答例の一覧を補足し、既存解答の過大な説明を修正します。初級・中級・上級すべての既存教材が対象です。
    The scope is workshop documentation across all three difficulty levels and the scenario structure check. Extend category guidance and the example index, and correct overstatements in existing answers.

  • 画面は2026-10-02に撮影し、本文・リンク・実行例は2026-10-13に確認しています。実際に読んだ範囲と、実施していない追加調査を明記します。
    Screenshots were captured on 2026-10-02; prose, links, and execution examples were verified on 2026-10-13. State the evidence reviewed and further work not performed.

  • シナリオ構造検査で、難易度を持たないチュートリアルの画像フォルダーを誤検出しないよう対象を修正します。
    Correct the structure check so tutorial asset directories are not treated as scenario difficulty directories.

  • 全31回答例で、原文の語句・識別子・条件式を日本語の意味と問題への適用に対応付けます。主体・対象・時点・条件を訳で省略しないよう補足し、2026-10-14に一次資料を再確認しました。
    In all 31 examples, connect source terms, identifiers, and conditions to their Japanese meaning and application to the problem. Clarify actors, objects, timing, and conditions against primary sources rechecked on 2026-10-14.

チェックリスト

  • 設問数が難易度の目安に沿っている(初級: 2 つほど / 中級: 3 つ / 上級: 制限なし) — 既存の設問数を維持。Existing question counts are preserved.
  • 解説に「どの一次情報を・どうたどるか」の調査ルートを書いた — 読解・解釈・続きの調査例を記載。Examples explain primary-source navigation, interpretation, and follow-up research.
  • コードやコマンドを含む場合、手元で動作確認した — Go 1.27.1で確認し、更新された問題例も再実行。Verified locally on Go 1.27.1, including reruns of updated examples.

検証: 最新mainに対する30シナリオの構造検査、68 Markdownの内部リンク、91設問リンクとアンカー、69画像の参照、差分チェックを通過。参照URLのHTTPステータスも確認済みです。入力例中の example.com は出典リンクの検査対象から除外しています。

Validation: passed structure checks for all 30 scenarios, local-link checks across 68 Markdown files, all 91 question links and anchors, 69 image references, and the whitespace check. Verified reference URL HTTP statuses; example.com values in sample input are not source links.

CI構造検査の実際のコマンドでも30シナリオが通過。不正な難易度とREADME欠落を検出することも確認しました。

The exact CI structure command passes for all 30 scenarios. Also verified that invalid difficulty directories and missing scenario READMEs still fail.

@tomtwinkle tomtwinkle added documentation Improvements or additions to documentation 初級 初級: ◯◯を見かけました。どんなものか調べてみましょう(設問2つほど) 中級 中級: ◯◯をやりたいです。どういうふうにやればいいか調べよう(設問3つ) 上級 上級: なんでこうなってるの?背景を調べよう labels Oct 13, 2026
@tomtwinkle
tomtwinkle marked this pull request as ready for review October 16, 2026 00:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation 上級 上級: なんでこうなってるの?背景を調べよう 中級 中級: ◯◯をやりたいです。どういうふうにやればいいか調べよう(設問3つ) 初級 初級: ◯◯を見かけました。どんなものか調べてみましょう(設問2つほど)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant