docs: archive workshop-era docs to docs/archive/#62
Merged
Conversation
Closes cdhagmann#45. The Blue Ridge Ruby 2026 workshop concluded 2026-05-02. Move workshop.md and prep-plan.md to docs/archive/ so they stay preserved without cluttering the active doc surface. Add docs/archive/README.md explaining what's there and why. Cross-references updated: - docs/index.md: workshop attendee paragraph - docs/claude-code-prompt.md: three prep-plan.md links - docs/adr/0010-charm-ruby-tui-framework.md: two workshop.md links - docs/adr/0013-revert-to-rooibos.md: one workshop.md link Out of scope per issue body: docs/talk/ stays where it is (canonical source for the published GitHub Pages URL). Note: docs/workshop-issues/ was listed in the issue scope but does not exist in the tree, so no move was performed for it.
4 tasks
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
2 participants
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.
Summary
Move
docs/workshop.mdanddocs/prep-plan.mdtodocs/archive/, update the cross-references that pointed at the old paths, and add a shortdocs/archive/README.mdexplaining what's in there.Linked issue / ADR
Closes #45. No ADR needed; the disposition decision is already documented as Q8 in
docs/OPEN_QUESTIONS.mdand as the "On the workshop docs" consequence in ADR-0013.Working agreement
bin/rubocopandbin/rspecpass locally (no Ruby touched, docs-only)Test plan
grep -rE "(^|[^/])workshop\.md|(^|[^/])prep-plan\.md" docs/ --include="*.md"after the move returns only:docs/archive/workshop.md,docs/archive/prep-plan.md)docs/archive/README.mdpointing at themOPEN_QUESTIONS.mdQ8 decision note, which is the documented decision text and stays unchangedgit diff --statsummary:Notes for reviewer
Two things worth flagging:
docs/workshop-issues/is listed in the issue scope but does not exist in the working tree (ls docs/confirms). I left a note in the commit message; happy to follow up if I missed where it lives.docs/talk/is untouched per the issue body's explicit exclusion (canonical source for the published GitHub Pages URL).docs/index.md's workshop attendee paragraph was rewritten from "if you're attending Blue Ridge Ruby 2026" to past-tense referencing the archive, since the workshop has now concluded. If you'd rather drop the paragraph entirely instead of pointing at the archive, easy to amend.