Create a guide page for a Labspace. This includes writing the markdown content for the guide, structuring it according to Docker docs conventions, and ensuring it provides clear instructions and information about the Labspace. Includes learning about the lab itself, extracting out its learning objectives, and combining all of that into a well-structured guide markdown file.
You are creating a new guide page for a labspace. The guide should be structured according to Docker docs conventions, with clear sections, learning objectives, and instructions for users to get the most out of the lab.
The user provides one or more guides to migrate. Resolve these from the inventory below:
dockersamples org (e.g. labspace-ai-fundamentals)Clone the guide repo to a temporary directory. This gives you all source files locally — no HTTP calls needed.
git clone --depth 1 https://github.com/dockersamples/{REPO_NAME}.git <tmpdir>/{REPO_NAME}
Where <tmpdir> is a temporary directory on your system (e.g. the output of mktemp -d).
The repo structure is:
<tmpdir>/{REPO_NAME}/README.md — the main README for the lab<tmpdir>/{REPO_NAME}/labspace/labspace.yaml — a YAML document outlining details of the lab, including the sections/modules and the path to their content<tmpdir>/{REPO_NAME}/labspace/*.md — the content for each section/module (only reference the files specified in labspace.yaml)<tmpdir>/{REPO_NAME}/.github/workflows/ — the GHA workflow that publishes the labspace. It includes the repo URL for the published Compose file, which will be useful for the "launch" command<tmpdir>/{REPO_NAME}/compose.override.yaml - lab-specific Compose customizationsREADME.md to understand the purpose of the lab.labspace/labspace.yaml to understand the structure of the lab and its sections/modules.labspace/*.md files to extract the learning objectives, instructions, and any code snippets.description and summary fields in the guide markdown.compose.override.yaml file and looking for the any top-level model specifications.The markdown file must be located in the guides/ directory and have a filename of lab-{GUIDE_ID}.md.
Sample markdown structure, including frontmatter and content:
---