Skip to content

Commit 4fb5b85

Browse files
author
DavidQ
committed
PR_SHOWCASE_GAME_CARD_CONTENT_UPDATE_FULL
Updates Asteroids and Breakout showcase card content in games/index.html while preserving existing game order. Includes: - Debug Showcase Entry messaging - Playable Now / Debug Showcase labels - Play / Debug Mode actions - Debug Tour / Getting Started links - onboarding helper text
1 parent 8b58002 commit 4fb5b85

14 files changed

+237
-65
lines changed

‎docs/dev/CODEX_COMMANDS.md‎

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,27 +2,32 @@ MODEL: GPT-5.3-codex
22
REASONING: medium
33

44
COMMAND:
5-
Create PR_PRODUCTIZATION_DISTRIBUTION_STARTER_FULL
5+
Create PR_SHOWCASE_GAME_CARD_SAFE_FINISH_FULL
66

77
PURPOSE:
8-
Define how showcase samples (Asteroids, Breakout) are packaged, presented, and shared as a product.
8+
Finish the Debug Showcase presentation in games/index.html without breaking the existing card structure and order. Place showcase data on existing cards.
99

1010
IN SCOPE:
11-
- showcase landing page structure
12-
- sample discovery (games/index.html improvements)
13-
- packaging strategy (standalone vs repo)
14-
- asset bundling rules
15-
- entry points for users (play vs debug)
11+
- preserve current game order exactly
12+
- preserve current anchor-card structure exactly
13+
- keep Debug Showcase badge in header
14+
- keep Debug Showcase badges on Asteroids and Breakout cards
15+
- add safe non-interactive showcase copy to Asteroids and Breakout cards
16+
- add a shared showcase intro/help block above the relevant game grid
17+
- place Debug Tour and Getting Started links in the shared showcase intro block, not inside cards
18+
- add onboarding helper text in the shared showcase block
1619

1720
OUT OF SCOPE:
18-
- engine changes
19-
- Track G
20-
- Track H
21+
- no nested links inside cards
22+
- no buttons inside cards
23+
- no engine changes
24+
- no unrelated card edits
2125

2226
RULES:
23-
- docs-first
24-
- no BIG_PICTURE_ROADMAP edits
25-
- PRODUCTIZATION_ROADMAP updates are bracket-only
27+
- surgical change only
28+
- preserve existing layout patterns
29+
- do not reorder games
30+
- do not convert card anchors into multi-action containers unless explicitly required later
2631

2732
OUTPUT:
28-
<project folder>/tmp/PR_PRODUCTIZATION_DISTRIBUTION_STARTER_FULL_bundle.zip
33+
<project folder>/tmp/PR_SHOWCASE_GAME_CARD_SAFE_FINISH_FULL_bundle.zip

‎docs/dev/COMMIT_COMMENT.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
PR_PRODUCTIZATION_DISTRIBUTION_STARTER_FULL
2-
docs: define productization distribution starter contracts for showcase packaging and entry flows
1+
PR_SHOWCASE_GAME_CARD_SAFE_FINISH_FULL
2+
chore(showcase): safely finish Asteroids/Breakout showcase card presentation with shared intro/help block and non-interactive card copy

‎docs/dev/NEXT_COMMAND.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
PLAN_PR_PRODUCTIZATION_DISTRIBUTION_IMPLEMENTATION_PASS_1
1+
PLAN_PR_SHOWCASE_ACCESSIBILITY_AND_COPY_REVIEW

‎docs/dev/reports/change_summary.txt‎

Lines changed: 14 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,20 @@
11
Toolbox Aid
22
David Quesenberry
3-
04/05/2026
3+
04/06/2026
44
change_summary.txt
55

6-
Executed PR_PRODUCTIZATION_DISTRIBUTION_STARTER_FULL as docs-only PLAN/BUILD/APPLY.
6+
Executed PLAN + BUILD + APPLY for SHOWCASE_GAME_CARD_SAFE_FINISH.
77

8-
Added:
9-
- `docs/pr/PLAN_PR_PRODUCTIZATION_DISTRIBUTION_STARTER.md`
10-
- `docs/pr/BUILD_PR_PRODUCTIZATION_DISTRIBUTION_STARTER.md`
11-
- `docs/pr/APPLY_PR_PRODUCTIZATION_DISTRIBUTION_STARTER.md`
8+
Implemented in `games/index.html`:
9+
- Added a shared showcase intro/help block above the relevant game grid.
10+
- Placed Debug Tour and Getting Started links in the shared intro block.
11+
- Added onboarding helper text in the shared intro block.
12+
- Updated Asteroids and Breakout card copy with safe non-interactive showcase messaging.
13+
- Kept Debug Showcase badge in header and on both showcase cards.
1214

13-
Defined:
14-
- showcase landing page structure
15-
- discovery guidance for `games/index.html`
16-
- standalone vs repo-linked packaging strategy
17-
- asset bundling include/exclude rules
18-
- user entry points for play, debug, and demo
19-
20-
Roadmap update:
21-
- `docs/dev/PRODUCTIZATION_ROADMAP.md` Track R states moved to in-progress via bracket-only edits.
22-
23-
Scope guard:
24-
- Docs-first only
25-
- No engine changes
26-
- No Track G/H work
27-
- No BIG_PICTURE roadmap edits
15+
Safety guardrails met:
16+
- Preserved existing game order exactly.
17+
- Preserved existing anchor-card structure exactly.
18+
- No nested links/buttons inside cards.
19+
- No engine/runtime changes.
20+
- No unrelated card edits.

‎docs/dev/reports/file_tree.txt‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
Toolbox Aid
22
David Quesenberry
3-
04/05/2026
3+
04/06/2026
44
file_tree.txt
55

6-
docs/pr/PLAN_PR_PRODUCTIZATION_DISTRIBUTION_STARTER.md
7-
docs/pr/BUILD_PR_PRODUCTIZATION_DISTRIBUTION_STARTER.md
8-
docs/pr/APPLY_PR_PRODUCTIZATION_DISTRIBUTION_STARTER.md
9-
docs/dev/PRODUCTIZATION_ROADMAP.md
6+
docs/pr/PLAN_PR_SHOWCASE_GAME_CARD_SAFE_FINISH.md
7+
docs/pr/BUILD_PR_SHOWCASE_GAME_CARD_SAFE_FINISH.md
8+
docs/pr/APPLY_PR_SHOWCASE_GAME_CARD_SAFE_FINISH.md
109
docs/dev/codex_commands.md
1110
docs/dev/commit_comment.txt
1211
docs/dev/next_command.txt
1312
docs/dev/reports/change_summary.txt
1413
docs/dev/reports/validation_checklist.txt
15-
docs/dev/reports/file_tree.txt
14+
docs/dev/reports/file_tree.txt
15+
games/index.html

‎docs/dev/reports/validation_checklist.txt‎

Lines changed: 17 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,27 @@
11
Toolbox Aid
22
David Quesenberry
3-
04/05/2026
3+
04/06/2026
44
validation_checklist.txt
55

66
[x] PLAN doc created
77
[x] BUILD doc created
88
[x] APPLY doc created
9-
[x] Landing page structure defined
10-
[x] Discovery improvements contract defined
11-
[x] Standalone vs repo-linked packaging strategy defined
12-
[x] Asset bundling rules defined
13-
[x] User entry points defined
14-
[x] Docs-only scope preserved
15-
[x] No BIG_PICTURE_ROADMAP edits
16-
[x] PRODUCTIZATION_ROADMAP updates are bracket-only
17-
[x] No Track G/H work
9+
[x] Current game order preserved exactly
10+
[x] Current anchor-card structure preserved exactly
11+
[x] Debug Showcase badge retained in header
12+
[x] Debug Showcase badges retained on Asteroids and Breakout cards
13+
[x] Safe non-interactive showcase copy added to Asteroids and Breakout cards
14+
[x] Shared showcase intro/help block added above relevant game grid
15+
[x] Debug Tour and Getting Started links placed in shared intro block
16+
[x] Onboarding helper text added in shared showcase block
17+
[x] No nested links inside cards
18+
[x] No buttons inside cards
19+
[x] No engine changes
20+
[x] No unrelated card edits
1821
[x] Repo-structured bundle zip created
1922

2023
Validation checks:
21-
- `git diff --name-only`
22-
- `git diff -- docs/dev/PRODUCTIZATION_ROADMAP.md`
23-
- `tar -tf tmp/PR_PRODUCTIZATION_DISTRIBUTION_STARTER_FULL_bundle.zip`
24+
- `rg -n "showcaseIntro|Debug Tour|Getting Started|Asteroids \(Debug Showcase\)|Breakout \(Debug Showcase\)" games/index.html`
25+
- `git diff -- games/index.html`
26+
- order check script comparing card href sequence against HEAD
27+
- `tar -tf tmp/PR_SHOWCASE_GAME_CARD_SAFE_FINISH_FULL_bundle.zip`

‎docs/pr/APPLY_PR_SHOWCASE_GAME_CARD_SAFE_FINISH.md‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
Toolbox Aid
2+
David Quesenberry
3+
04/06/2026
4+
APPLY_PR_SHOWCASE_GAME_CARD_SAFE_FINISH.md
5+
6+
# APPLY_PR_SHOWCASE_GAME_CARD_SAFE_FINISH
7+
8+
## Apply Decision
9+
Apply BUILD_PR_SHOWCASE_GAME_CARD_SAFE_FINISH exactly as scoped.
10+
11+
## Applied Scope
12+
- Added shared showcase intro/help block above relevant game grid.
13+
- Kept showcase docs links in shared intro block (not cards).
14+
- Updated Asteroids and Breakout cards with safe non-interactive showcase copy.
15+
- Preserved order and anchor-card structure.
16+
17+
## Validation Summary
18+
- No game reorder.
19+
- No card structure changes.
20+
- No nested links/buttons inside cards.
21+
- No engine/runtime changes.
22+
- No unrelated card edits.
23+
24+
## Output
25+
`<project folder>/tmp/PR_SHOWCASE_GAME_CARD_SAFE_FINISH_FULL_bundle.zip`

‎docs/pr/BUILD_PR_SHOWCASE_GAME_CARD_SAFE_FINISH.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
Toolbox Aid
2+
David Quesenberry
3+
04/06/2026
4+
BUILD_PR_SHOWCASE_GAME_CARD_SAFE_FINISH.md
5+
6+
# BUILD_PR_SHOWCASE_GAME_CARD_SAFE_FINISH
7+
8+
## Build Summary
9+
Implemented a surgical, safe-finish update in `games/index.html` to complete Debug Showcase presentation without altering game order or anchor-card structure.
10+
11+
## Implemented Changes
12+
1. Shared showcase intro/help block added above the Playable grid:
13+
- Includes showcase entry messaging.
14+
- Includes Asteroids and Breakout Play/Debug path links.
15+
- Includes docs links:
16+
- Debug Tour
17+
- Getting Started
18+
- Includes onboarding helper guidance.
19+
20+
2. Asteroids and Breakout card updates (text-only, non-interactive):
21+
- Retained `Playable Now` + `Debug Showcase` badges.
22+
- Updated titles to explicit `(Debug Showcase)` naming.
23+
- Updated descriptions to safe showcase-oriented copy.
24+
25+
3. Safety constraints preserved:
26+
- No nested links/buttons inside cards.
27+
- Existing card anchors remain single-link containers.
28+
- Game order unchanged.
29+
- No unrelated card edits.
30+
31+
## Validation
32+
- Confirmed showcase intro block exists above relevant game grid.
33+
- Confirmed Asteroids and Breakout cards keep badges and safe copy.
34+
- Confirmed no nested links/buttons inside card bodies.
35+
- Confirmed anchor-card order unchanged.

‎docs/pr/PLAN_PR_SHOWCASE_GAME_CARD_SAFE_FINISH.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
Toolbox Aid
2+
David Quesenberry
3+
04/06/2026
4+
PLAN_PR_SHOWCASE_GAME_CARD_SAFE_FINISH.md
5+
6+
# PLAN_PR_SHOWCASE_GAME_CARD_SAFE_FINISH
7+
8+
## Goal
9+
Finish Debug Showcase presentation in `games/index.html` safely by placing showcase guidance on existing cards and a shared intro block while preserving card structure and order.
10+
11+
## Workflow
12+
PLAN_PR -> BUILD_PR -> APPLY_PR
13+
14+
## In Scope
15+
- Preserve current game order exactly.
16+
- Preserve current anchor-card structure exactly.
17+
- Keep Debug Showcase badge in header.
18+
- Keep Debug Showcase badges on Asteroids and Breakout cards.
19+
- Add safe non-interactive showcase copy to Asteroids and Breakout cards.
20+
- Add shared showcase intro/help block above relevant game grid.
21+
- Place `Debug Tour` and `Getting Started` links in shared showcase intro block (not inside cards).
22+
- Add onboarding helper text in shared showcase block.
23+
24+
## Out of Scope
25+
- Nested links inside cards.
26+
- Buttons inside cards.
27+
- Engine/runtime changes.
28+
- Unrelated card edits.
29+
30+
## Acceptance Criteria
31+
- Card order is unchanged.
32+
- Card anchor structure remains unchanged.
33+
- Only Asteroids/Breakout card text changes.
34+
- Shared intro block contains Play/Debug paths, docs links, and onboarding text.
35+
- No interactive controls are embedded inside cards.

‎docs/release/debug_showcase_getting_started.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
Toolbox Aid
2+
David Quesenberry
3+
04/06/2026
4+
debug_showcase_getting_started.md
5+
6+
# Debug Showcase Getting Started
7+
8+
## Quick Start
9+
1. Open `/games/index.html`.
10+
2. Choose Asteroids or Breakout in Play mode.
11+
3. Re-open with `?debug=1` to enable debug surfaces.
12+
4. Use Debug Tour for guided validation flow.
13+
14+
## URL Patterns
15+
- Play: `/games/<Sample>/index.html`
16+
- Debug: `/games/<Sample>/index.html?debug=1`
17+
- Optional Demo (if enabled in sample): `/games/<Sample>/index.html?debugDemo=1`
18+
19+
## First-Time Guidance
20+
- Keep Play first, then enter Debug intentionally.
21+
- Validate no gameplay dependency on debug tools.
22+
- Confirm docs and controls are discoverable from the game cards.
23+
24+
## Related Docs
25+
- [Debug Showcase Tour](./debug_showcase_tour.md)
26+
- [Release Docs Index](./README.md)

0 commit comments

Comments
 (0)