| name | new-tutorial |
| description | Scaffold a new Python Central Hub tutorial .mdx page with correct frontmatter, DataCampExercise blocks, and site conventions. Use when the user wants to add a new tutorial/doc page under src/content/docs. |
New Tutorial Page
Scaffold a Starlight .mdx tutorial that matches this repo's conventions.
Location & filename
- Pages live under
src/content/docs/<Module>/<Phase N - ...>/<Title>.mdx.
- Windows-invalid filenames: NEVER put
" : * ? < > | \ / in a filename. The repo already has ~11 files with literal " that Git cannot check out on Windows — do not create more. Use plain ASCII, spaces allowed.
- A phase folder usually has an overview
.mdx named after the folder itself.
Frontmatter (required)
---
title: <Human Title>
description: <one sentence, SEO-worthy>
sidebar:
order: <int — controls sidebar position within module>
---
Section-overview pages use only title + description (+ order). Landing (index.mdx) is special — do not mimic it.
Body structure
## What you'll learn — bullet list.- Concept prose (Poppins body). Headings are
## / ###.
- Code samples use fenced blocks with a filename + line numbers:
```python title="example.py" showLineNumbers{1}
- Signature motif: use the
>>> REPL prompt as a structural marker where a shell interaction is shown.
Interactive exercises (DataCampExercise)
Append a ## 🧪 Try It Yourself section with 3 <DataCampExercise> blocks.
Import path is depth-relative. Count folders from src/content/docs to the file, then:
import DataCampExercise from "<../ × depth>components/DataCampExercise.astro";
(e.g. a file 3 folders deep → ../../../../components/DataCampExercise.astro).
Each block:
<DataCampExercise
lang="python"
hint={`Use \`fn()\` to ...`}
code={`# Task: <title>
import os
files = os.___( "." ) # blank for learner to fill
print("Found files:", len(files) > 0)`}
solution={`import os
files = os.listdir(".")
print("Found files:", len(files) > 0)`}
sct={`test_output_contains("Found files: True")
success_msg("Nice!")`}
height={125}
/>
Rules: backticks inside template literals must be escaped \``. code has a fill-in-the-blank (___), solutionis complete,sct uses DataCamp SCT helpers (test_output_contains, success_msg, test_function). Tune height` to content (~120–160).
Verify
- Bump/renumber
sidebar.order if inserting between existing pages.
- Confirm the import
../ depth by counting, not guessing.
- Do not run
git add -A (would stage deletion of the Windows-invalid files). Do not commit.
See project memory design-system and repo-gotchas.
