Skip to content

docs: 45th の作業の経緯と細かい手順のうち、文書に入りきらなかったものを足す #596

Description

@taminororo

開発目的

45th の作業の記録を文書に移したとき、文書に入りきらなかった「経緯」と「細かい手順」を足す。どれも、決めたことや直し方はすでに文書にある。足りないのは、選ばなかった案とその理由、作業のときに気をつけることである。急ぎではないので、関係する文書を直すときに合わせて足していく。

考えられる開発内容

解説マニュアルの作業(docs/development/manual-html-operations.md、docs/operations/spreadsheet-map.md)

  • 短い元の Doc は、LLM で生成せず、Docs の HTML と画像を書き出して手で組む。理由(LLM の出力で CSS や連絡先の組み方が揺れ、途中で切れることがあった)も書く
  • 正式な確認に出す版は、連絡先を伏せずに原文どおりにする。その前提(閲覧できるのは委員に限られる)も書く
  • Docs で画像をトリミングしても変換で消えるので、生成の前に、切り出した形で画像に焼き込む
  • 直す範囲は、依頼者の説明ではなく、新旧の原文(本文と画像)を比べて決める。差分がゼロなら、対象の取り違えを疑う
  • 既定のモデルを今のものに切り替えた根拠(PR fix: 解説マニュアル生成の既定のモデルを Opus 5.5 に上げる #576 の前に試した結果)
  • HTML にするマニュアルを絞った理由(全部を HTML にする余力が無かった)
  • Drive やスプレッドシートの ID を GAS の定数に直接書いてよいか、の判断と理由
  • 2026-09-17 にマニュアル名の表記ゆれを直したときの教訓(対応表の列と、タスク一覧の列のどちらを直すか)
  • 生成した HTML を直すときの直し方(作り直すときに、手で直した箇所が上書きされること)

45th のシフトのスプレッドシートの事故(docs/operations/incidents-45th.md、docs/operations/spreadsheet-map.md)

  • 元のスプレッドシートと執行部のコピーが並んで混乱し、どちらを元にするかを決めた経緯
  • 参加不可の申告が別の人の行にずれた件で、版を戻す案を選ばなかった理由
  • 参加不可の警告を、セルのメモから黒塗りに変えた理由
  • 人数チェックを GAS に移した理由(前年の版は数式だけでできていて重かった)と、トリガーを画面から手で設置した理由
  • 日程シートのプルダウンの候補を絞る案を見送った理由
  • 日程シートが一面赤くなった件で、「数式を触らずに待つ」案では戻らなかったこと

lint の設定(api/.golangci.yml、.github/workflows/go-lint.yml のコメント)

  • gosec に SQL の組み立てを拾わせるための応急の書き換えを、プレースホルダにそろえることで不要になったため見送ったこと
  • 設定ファイルの場所を移す案や go.work を置く案では CodeRabbit の失敗が直らなかったこと、CodeRabbit の golangci-lint を止める案を取らなかったこと

考えられる開発時間

まとめてやるなら4時間程度。文書を直すついでに1つずつ足すのでもよい。

備考

公開リポジトリなので、個人名・スプレッドシートや Drive の ID・本番の値は書かない。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions