Repository navigation
feat(component): DockerRun.astro + AGENTS.md container section (MR2 site-side) - #37
Merged
Merged
Conversation
Adds the site-side companion to MR2 (containers v1) on the C++26 examples repo. Renders a copy-pastable docker run block + container badge + optional collapsible expected-output section. Visual cousin of GodboltEmbed -- same card grammar, different verb (godbolt opens the URL; DockerRun shows the command). Placeholder mode kicks in when image starts with "TODO" -- mirrors the same affordance in GodboltEmbed for posts that have the slot but not yet the wired-up id. Cluster name auto-derived from image ref (ghcr.io/wrocpp/cpp-<cluster>:<tag>) for the badge. Also updates the AGENTS.md template inside ai-coding-agents-for-cpp.mdx to enumerate all 6 wro.cpp containers + the standard mount-and-run pattern. Once readers wire AGENTS.md into their projects, their coding agents know to pull the matching wro.cpp image rather than installing toolchains by hand. Build clean (111 pages). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The AGENTS.md template inside ai-coding-agents-for-cpp.mdx is meant as a generic, copy-pasteable starter for readers' own projects. Adding a wro.cpp-specific container enumeration turned it into a self-promo advert that has nothing to do with how readers configure their own agents. Container reference belongs in containers/README.md (c++26 repo) and in per-toolset-section DockerRun blocks (which is exactly what the DockerRun.astro component is for) -- not jammed into the AI-agents page. The DockerRun.astro component itself stays; that's the right vehicle. 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
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
Site-side companion of MR2 (containers v1). The C++26 examples repo PR ships 6 GHCR images (cpp-base + cpp-safety + cpp-performance + cpp-security + cpp-compliance + cpp-reflection); this PR ships the site components that surface them on toolset pages.
What lands
src/components/DockerRun.astro-- new component. Renders a "Reproduce locally" card with a copy-pastabledocker run ...block, container badge (auto-derived from image ref), optional collapsible expected-output. Visual cousin ofGodboltEmbed.astro.imagestarts withTODO(mirrors GodboltEmbed pattern for posts that have the slot before the image is wired).-v "$PWD":/work -w /work(matches the toolset README convention).src/content/toolset/ai-coding-agents-for-cpp.mdx-- AGENTS.md template gains a "Local reproduction (wro.cpp containers)" section enumerating all 6 images + the standard mount-and-run pattern. Once readers wire AGENTS.md into their projects, their coding agents know to reach for the wro.cpp images rather than installing toolchains by hand.Schema fields (
containerImage,containerEntry,exampleRepo) already shipped in MR1.1; nothing to add here.Usage example
Each toolset section MR (MR3 sanitizers, MR4 safety-profiles, ...) wires up its DockerRun blocks.
Test plan
NODE_ENV=production npm run buildclean (111 pages, unchanged count)Sequencing with MR2-c++26
Lands together with the c++26 PR wrocpp/cpp26-reflection-examples#1. Either order works -- this PR has no runtime dependency on the GHCR images (they're just strings in the AGENTS.md template); the C++26 PR has no dependency on the site changes.
🤖 Generated with Claude Code