Function write_project_pages

tools/build_starlight_content.py:1095–1195

(projects: list[dict])

def write_project_pages(projects: list[dict]) -> None:
    project_dir = TARGET_DOCS / "projects"
    project_dir.mkdir(parents=True, exist_ok=True)
    for project in projects:
        raw_readme = project["readme"].read_text(encoding="utf-8")
        source_anchor = original_readme_anchor(raw_readme)
        readme = raw_readme
        readme = strip_first_h1(readme)
        readme = rewrite_project_readme_links(readme, project["dir"])
        readme = demote_markdown_headings(readme)
        tags = project_tags(project)
        summary = project_summary(project)
        content = (
            frontmatter(
                project["name"],
                order=project["number"],
                description=project["notes"],
            )
            + summary
            + f"""\n<div class="project-tags">
{tags}</div>

## Overview

{project['notes']}

## What You Will Build

<div class="lab-detail-grid">
  <div class="lab-panel">
    <span class="meta-label">Outcome</span>
    <strong>{escape_html(project['outcome_proof'])}</strong>
  </div>
  <div class="lab-panel">
    <span class="meta-label">Tools used</span>
    <strong>{escape_html(', '.join(project['tools']) or 'DevOps fundamentals')}</strong>
  </div>
  <div class="lab-panel">
    <span class="meta-label">Best fit</span>
    <strong>{project['skill_level']} - {project['time_estimate']}</strong>
  </div>
</div>

## Architecture Diagram

{architecture_diagram(project)}

## Prerequisites

{prerequisite_items(project)}

## Credentials And Cost Warning

{cost_warning(project)}

## Step-By-Step Lab

Use this flow before you run commands: