docs(manual): 画面写真つきの使い方マニュアルを納品する - #69
Merged
Merged
Conversation
実ブラウザで全機能をさわり、40 枚の画面写真を撮って docs/manual/manual.md にまとめた。giga-manual スキルの書式に沿わせ、 lint-manual は警告 0 件。 - 17 章 53 節。11 のタブと児童の受付操作を、機能のまとまりごとに章立て - 画面写真は 40 枚。押す場所には赤い枠を入れ、引きと寄りを分けた - 撮影に使ったデモ学級とシナリオを tools/manual-shots/ に残した。 実在する子どもは一人も含まれていない - MANUAL.md にあった「Google Fonts から丸ゴシックを読む」は現状と食い違う (fonts/ に自己ホスト済み)ため、マニュアルには持ちこんでいない 書いた内容はコードと突き合わせて直した。とくに次の 3 つは、 書いた本人には正しく見えたまま残るところだった。 - 提出率の母数から欠席を外すのは「おやすみ日の提案」だけで、 レポートの必要回数は欠席日も数える - 一括登録の出席番号は「最大番号から連番」ではなく、 空いている番号のうち小さいほうから割り当てる(画面の説明文のほうが古い) - 名簿に無い番号を打つと出るのは「IDがみつかりません」 更新ログにも 1 行足した(マニュアルは使う人から見て増えたもの)。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Cr3ptejpAPzJkhsqCJwr3g
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
何をしたか
実ブラウザで全機能をさわり、40 枚の画面写真を撮って
docs/manual/manual.mdにまとめました。giga-manual スキルの書式に沿わせ、lint-manual.mjsは警告 0 件です。tools/manual-shots/に残しました。実在する子どもは一人も含まれていませんdocs/CHANGELOG.mdに 1 行足しました(マニュアルは使う人から見て増えたもの)中身をコードと突き合わせて直したところ
書式の検査も、目で見ることも、書いてある中身が正しいかは見ません。本文の言い切っている文を根拠のコードへ戻して確かめたところ、3 か所ずれていました。
src/App.jsxのgenerateReportData)。当初は「欠席は母数から外れます」と書いていましたhandleAddBulkStudents)。画面に出ている説明文のほうが古くなっていますhandleScan)あわせて、
MANUAL.mdにある「Google Fonts から丸ゴシックを読んでいます」は現状と食い違う(fonts/に自己ホスト済み・CSP はfont-src 'self')ため、マニュアルには持ちこんでいません。撮れていない画面
検査
node .claude/skills/giga-manual/scripts/lint-manual.mjs docs/manual/manual.md… 警告 0 件node .claude/skills/giga-changelog/scripts/lint-changelog.mjs docs/CHANGELOG.md… 通過npm run check(lint → test → build → gate)… 0 error / 0 warningnode ../GIGAyama.github.io/standards/check-drift.mjs --standards ../GIGAyama.github.io/standards… 正本と一致tools/lib/article-md.mjs+manual-page.mjs)でページにして、実ブラウザで確認。壊れた画像 0・4xx 0・図の説明文に降格した本文なし。印刷は A4 で 57 ページ(1 章あたり約 3.4 ページ)ポータル側
このリポジトリの Pages は
dist/だけを配っているため、サブドメインからはdocs/manual/images/に届きません。控えが無いとraw.githubusercontent.comに落ち、GitHub を塞いでいる学校では画面写真が 1 枚も出ません。控えは
GIGAyama/GIGAyama.github.ioの同名ブランチに置いてあります(assets/manual/homework-barcordreader/の WebP 40 枚)。あわせてご確認ください。Generated by Claude Code