Skip to content

貢献経路を Issue / Discussion で再整理#1

Merged
watanabe-kohei-jp merged 1 commit into
mainfrom
feat/discussion-routing
May 12, 2026
Merged

貢献経路を Issue / Discussion で再整理#1
watanabe-kohei-jp merged 1 commit into
mainfrom
feat/discussion-routing

Conversation

@watanabe-kohei-jp
Copy link
Copy Markdown
Collaborator

Summary

action item は Issue、開いた会話は Discussion」を軸に貢献経路を再整理。

  • 質問・詰まり相談 → Discussions / Q&A
  • 学習ログ・気づき・応用事例 → Discussions / Show and tell
  • 章構成・方向性議論 → Discussions / Ideas
  • 教材の誤り・表示崩れ・具体的改善 → Issue (bug-report / improvement)
  • 直接修正 → PR

Changes

ファイル 変更
.github/ISSUE_TEMPLATE/question.yml 削除(Q&A へ移行)
.github/ISSUE_TEMPLATE/stuck.yml 削除(Q&A へ移行)
.github/ISSUE_TEMPLATE/bug-report.yml 新規(事実バグ報告用)
.github/ISSUE_TEMPLATE/config.yml Discussions への contact_links を追加
CONTRIBUTING.md 経路表を 5 系統に更新、使い分けの理由を明記
00-about/lecture.html Coda / AI Buddy スライドのルーティングを更新
01-claude-code-intro/lecture.html AI Buddy スライドのルーティングを更新

Test plan

  • 全スライドの scrollHeight === 1080 維持を確認(00-about 8 枚 / 01 11 枚)
  • 削除した template への参照がリポジトリ全体に残っていないことを確認
  • CI(Prompt Injection Guard)が green になることを確認

「action item は Issue、開いた会話は Discussion」を軸に整理。
質問・詰まり・気づき・応用事例は Discussions(Q&A / Show and tell /
Ideas)へ寄せ、Issue は教材の事実バグと具体的な改善提案に絞る。

- Issue templates: question/stuck を削除、bug-report を新規追加
- config.yml に Discussions への誘導リンク(Q&A / Show and tell / Ideas)
- CONTRIBUTING.md と 00-about・01-claude-code-intro の
  AI Buddy / Coda スライドのルーティングを 5 系統に更新
@watanabe-kohei-jp watanabe-kohei-jp merged commit 2aece1a into main May 12, 2026
1 check passed
@watanabe-kohei-jp watanabe-kohei-jp deleted the feat/discussion-routing branch May 12, 2026 01:54
watanabe-kohei-jp added a commit that referenced this pull request May 12, 2026
Lecture 01: 10 枚構成で Claude Code 入門に再構築
watanabe-kohei-jp added a commit that referenced this pull request May 12, 2026
貢献経路を Issue / Discussion で再整理
watanabe-kohei-jp added a commit that referenced this pull request May 12, 2026
Lecture 01: 10 枚構成で Claude Code 入門に再構築
watanabe-kohei-jp added a commit that referenced this pull request May 12, 2026
貢献経路を Issue / Discussion で再整理
watanabe-kohei-jp added a commit that referenced this pull request May 15, 2026
Lecture 01: 10 枚構成で Claude Code 入門に再構築
watanabe-kohei-jp added a commit that referenced this pull request May 15, 2026
貢献経路を Issue / Discussion で再整理
watanabe-kohei-jp added a commit that referenced this pull request May 23, 2026
「## 何が読めるか」テーブルでは 00-about/ を 10 枚、index.html 内も
10 セクションになっているのに、ルート A の説明だけ「思想を 9 枚で」
となっていた事実誤認を修正。

Codex レビュー指摘 #1 への対応。

Refs #32
watanabe-kohei-jp added a commit that referenced this pull request May 25, 2026
* docs(readme): 読み進め方ガイド(推奨ルート3パターン)を追加 (#32)

ユーザーから「この資料をどう読み進めればいいか具体的に教えてほしい」と
いう声を受けて、README に推奨ルートセクションを追加した。

- 「何が読めるか」テーブルに 02-setup / 03-claude-md を追加
  (現状 main にあるのに README から漏れていた)
- 「読み進め方(推奨ルート)」セクションを新設
  - ルート A: はじめての方(30 分) — 00 → 01 → 02
  - ルート B: Claude Code 経験者(25 分) — 00 → 03-claude-md → CLAUDE.md
  - ルート C: 作り手として読む方(45 分) — 00 → CONTRIBUTING → CLAUDE.md → shared/
- 「共通の前提」で「読むだけで終わらせない」「詰まったら Issue/Discussion」を再掲

章番号や全体構成の見直しは Issue #27 のスコープなので踏み込まない。
本コミットは現状の章をどう読むかのガイドに留める。

Refs #32

* docs(readme): 読み方のスタイル(3 パターン・両方おすすめ)を追加 (#32)

「読み進め方(推奨ルート)」セクションに、誰向け軸(ルート A/B/C)に
加えて「どう読むか」の軸を追加。

- パターン 1: スライドだけを見る(最短ルート)
- パターン 2: Claude Code に読ませて対話で読む(深掘り重視)
- パターン 3: 両方 ← おすすめ(スライド × AI 対話で読みながら Issue/PR まで流す)

パターン 3 にはコピペできる「最初の一声」も同梱し、Issue #32 原文の
「具体的に教えてほしい」に粒度で応える。

既存「## どう読むか」(媒体・操作話)とは別軸(スタイル話)なので
そちらには手を入れない。

Refs #32

* docs(readme): ルート A の章枚数を 10 枚に修正(テーブル表記と整合) (#32)

「## 何が読めるか」テーブルでは 00-about/ を 10 枚、index.html 内も
10 セクションになっているのに、ルート A の説明だけ「思想を 9 枚で」
となっていた事実誤認を修正。

Codex レビュー指摘 #1 への対応。

Refs #32

* docs(readme): 「最初の一声」に consent / anonymization / 5系統振り分けを追加 (#32)

Codex レビュー指摘 #2 への対応。コピペ用の「最初の一声」が
00-about/index.html Slide 8 の AI Buddy プロトコル
(consent-first / anonymization-first / 5 系統振り分け)の
制約を含んでおらず、AI が無断投稿・個人情報漏洩・粗い分類で
進む余地があった。

末尾に以下を追加して整合:
- 投稿案を作る前に同意確認を必須
- 個人情報(実名・会社名・社内パス・API キー等)の匿名化を必須
- Discussions(Q&A/Show and tell/Ideas)・Issue(bug-report/improvement)・PR の
  5 系統振り分けまで AI に促す

Refs #32

---------

Co-authored-by: watanabe-kohei-jp <283722319+watanabe-kohei-jp@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant