Skip to content

docs: オンボーディング資料の論の筋を1本にし、コードと食い違う記述を直す #592

Description

@taminororo

開発概要

目的

  • docs/development/onboarding.md(新しく入った人向けの技術オンボーディング資料)には、論の筋が2本に分かれている問題と、今のコードと食い違う記述がある。新入生がこの資料どおりに動いて迷ったり、誤った理解のまま作業を始めたりしないように直す。

開発期間

  • 開始日:2026-09-30
  • 締切日:

考えられる開発内容

  • 資料の軸を1本にする。冒頭で約束している「技術ごとに何を学ぶか」と、0節・13節が実際に問うている「コンパイラや CI が気づかず黙って壊れる場所」が別になっている
  • 担当の種類(api・mobile・GAS)の書き方を節どうしでそろえる
  • 5節「DI でテストがしやすい」と 10節「偽の repository は作れない」の食い違いを直す
  • 13節の「片方だけ作ればよい」を、mobile の担当が実際にできる課題にする
  • コードと食い違う記述を直す(JSON のキー名の食い違いが黙って通ること、api/env/dev.env のダミー値、make down で DB が消えること、widget テストに --platform chrome が要らないこと、LockService の待ち時間、clasp deploy -i、mobile の天気の固定、CI の docs-refcheck、ブランチ名の種類、など)
  • 図・用語・コード片に、Python を少し書いたことがある人向けの説明を足す

備考

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