docs: Add #884 demo-promotion cheatsheet + self-serve walkthrough#959
Open
bjagg wants to merge 1 commit into
Open
docs: Add #884 demo-promotion cheatsheet + self-serve walkthrough#959bjagg wants to merge 1 commit into
bjagg wants to merge 1 commit into
Conversation
…alkthrough Two operations docs from the 2026-05-26/27 self-serve push, both validated end-to-end against real environments before commit. - **`884-demo-promotion-cheatsheet.md`** — tactical runbook layered on the canonical `demo-environment-update.md`. Front-loads the LIF-Initiative#884-specific gotchas surfaced during the dev re-deploy session (Lambda image manifest, Flyway checksum drift, V1.3/V1.4 ordering, search_path fallback). Used to promote demo on 2026-05-27 and caught one missing step (SAM mdr-database) which the doc now includes. - **`self-serve-registration-walkthrough.md`** — tester checklist + admin/operator notes for the registration → workspace → invite → switch flow. Includes symptom → cause table for the most common failure modes. Also adds matching `INDEX.md` entries per the `docs-index` skill convention (alphabetical by filename within `docs/operations/guides/`; `884-` sorts to the top because numbers precede letters). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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
1 participant
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
Two operations docs from the 2026-05-26/27 self-serve push, both validated end-to-end against real environments before commit:
884-demo-promotion-cheatsheet.mdmdr-database) which is now part of the doc.self-serve-registration-walkthrough.mdAlso adds matching
INDEX.mdentries per thedocs-indexskill convention.Why these two together
Both touch the same workstream (#884) and reference each other. Splitting them into two PRs would just create extra review surface for the same reviewer who'd see them together anyway.
What this PR doesn't try to do
docs-indexskill: INDEX.md and the new files only)Test plan
docs-indexskill convention followed: ≤~150-char summaries, present tense, content-not-purpose descriptions, alphabetical placement within sectionmdr-database) which was the gap caught during the actual demo promotion🤖 Generated with Claude Code