Skip to content

docs(jekyll): update site, fix _config.yml excludes, archive planning docs#65

Merged
cdhagmann merged 1 commit into
mainfrom
docs-jekyll-and-archive
May 7, 2026
Merged

docs(jekyll): update site, fix _config.yml excludes, archive planning docs#65
cdhagmann merged 1 commit into
mainfrom
docs-jekyll-and-archive

Conversation

@cdhagmann

Copy link
Copy Markdown
Owner

Summary

Three related housekeeping items in one pass: the Jekyll site was stale, the _config.yml exclude list referenced paths that no longer exist, and two workshop-era planning docs had no home.

Linked issue / ADR

No issue — doc-only cleanup following the Phase 6 landing. No ADR.

Working agreement

  • Single concern (multi-concern PRs get bounced — see CLAUDE.md)
  • bin/rubocop and bin/rspec pass locally
  • New behavior has a test; bug fix has a regression test
  • Async work goes through Rooibos Commands (no direct threads / Async / synchronous shellouts)

Test plan

  • bundle exec rspec — 240 examples, no failures (no code changes)
  • bin/rubocop — no offenses
  • Verified docs/archive/ now contains claude-code-prompt.md and OPEN_QUESTIONS.md

Notes for reviewer

docs/index.md changes:

  • Status section: removes workshop framing, adds v1.x / v2.0 roadmap note
  • Quick start: adds init step, clarifies clone path
  • Commands table: adds init and fork; notes fix idempotency; says "contributable" not "good first issue"
  • Config table: all 5 keys (was only clone_root)

docs/_config.yml: exclude list pointed at prep-plan.md and workshop-issues/ which moved to archive/ in PR #62. Replaced with a single archive/ exclusion; also excludes OPEN_QUESTIONS.md (now archived).

Archived: claude-code-prompt.md was the Claude Code bootstrap prompt from the workshop build session — already excluded from Jekyll, now lives alongside the other workshop artifacts. OPEN_QUESTIONS.md served its v1 planning purpose; all questions are answered or tracked as issues.

docs/index.md:
- Status section rewritten — remove workshop framing, add v1.x/v2.0 roadmap note
- Quick start: add `init` step, clarify clone path
- Commands table: add `init` and `fork`; update `fix` to mention idempotency; update `issues` to say "contributable"
- Config table: expand from 1 key to all 5 (editor, ai_tool, comment_on_fix, preferred_labels)

docs/_config.yml:
- Exclude `archive/` instead of the now-moved individual files (claude-code-prompt.md, prep-plan.md, workshop-issues/)
- Also exclude OPEN_QUESTIONS.md (now archived)

Archive:
- docs/claude-code-prompt.md → docs/archive/ (workshop bootstrap prompt, served its purpose)
- docs/OPEN_QUESTIONS.md → docs/archive/ (all v1 questions resolved or tracked as issues)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@cdhagmann cdhagmann merged commit 9e334ed into main May 7, 2026
2 checks passed
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