docs: 大会運営・開発の画面付きHTML手順書を追加 - #3
Merged
Merged
Conversation
画像の識別名を指定してBase64データURLを更新する。画像ファイルの形式と対象タグを検証し、PNGやJPEGをGitに追加せず差し替えられるようにする。
2部の入口、実操作に沿った手順、図表、11枚のBase64スクリーンショットを用意。オフライン閲覧、画像の原寸表示、スマートフォン表示、印刷に対応する。
HTML手順書への案内と作成時の判断を記録し、整形対象へ追加する。既存WebApp READMEのDB必須記述と、技術要件の旧ファイル参照を現在の構成に合わせる。
arumino-om
requested changes
Sep 23, 2026
見出し用スタイルを注意書き直下のstrong要素に限定し、本文中の「1戦」が独立した行になる問題を修正する。警告色の指定も同じ範囲にそろえる。 確認: 両手順書を1440px・390pxで表示し、見出しと本文のレイアウトを確認。Prettierとgit diff --checkが成功。
操作説明の文体と句点を統一し、長いコマンドを内容を変えずに分割する。練習例の目的を明示し、図の遅延読み込みを外して全ページ撮影時の欠落を防ぐ。 確認: 1440px・390pxの描画、全画像の初期読込、画像内容とコマンド内容の維持、zsh構文検査、A4印刷、整形検査。
初回14件の指摘、採用・見送りの理由、抽出と撮影の制約、ローカル検証を保存する。API 429で修正後の再レビューが未完了であることも明記する。画像・PDFやAPIキーは含めない。
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.

変更内容
当日の運営操作と開発・復旧の手順が複数の設計資料に分散していたため、実画面・図・表を使ったHTML手順書を2部構成で追加します。
手順書の入口は
chros/public/manual/index.htmlです。アプリ起動中は/manual/index.htmlを開きます。サーバーなしで読む場合は、manualフォルダー全体を保存してindex.htmlをブラウザーで開きます。GitHubのファイル画面はHTMLソースの表示になるため、閲覧方法をREADMEにも記載しています。レビューの順序
マージ後のdevelop(
f00a3f2)からcodex/html-user-manualsを作成しました。5975c7f画像更新ツール3721dc7HTML手順書48f5c76案内と開発基準Base64部分は画像を表示して確認し、前後の代替テキスト・図の説明・手順をレビューしてください。撮影は本番データと別の保存先で行い、すべて架空の参加者を使用しています。
検証
判断と範囲
作成時の判断と更新方法は
docs/manuals.mdに記載しています。採点・保存・運営画面のアプリ実装は変更していません。釧路向けの計算や配置は現在の試作の判断として説明し、公式規則との確認箇所を明記しました。GitHub Pagesの公開設定とDocker実機検証は含めていません。