Function write_start_here_page

tools/build_starlight_content.py:818–855

()

def write_start_here_page() -> None:
    cards = "\n".join(start_route_card(route) for route in START_ROUTES)
    route_proof_cards = "\n".join(
        f"""  <a class="path-card" href="{site_path(route['href'])}">
    <strong>{escape_html(route['label'])}</strong>
    <p>{escape_html(route['summary'])}</p>
    <small>{escape_html(route['proof'])}</small>
  </a>"""
        for route in START_ROUTES
    )
    content = f"""{frontmatter(
        "Start Here",
        description="Choose the right DevOps learning route before opening a project.",
    )}
Use this page when you do not yet know which project to open. Pick the route
that matches your current goal, then move into the project cards and internal
lab pages.

<div class="start-route-grid">
{cards}
</div>

## Route Proof Checklist

<div class="path-grid">
{route_proof_cards}
</div>

## Before You Run Anything

1. Read the [credentials and cost safety guide]({site_path('/runbooks/credentials-and-cost-safety/')}).
2. Prefer projects marked `Works locally: Yes` while learning a new tool.
3. For cloud labs, confirm `Cleanup: Yes` or write your own destroy checklist before provisioning.
4. Capture validation output and screenshots so the project becomes portfolio evidence, not only practice.
"""
    path = TARGET_DOCS / "catalog" / "start-here.md"
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content, encoding="utf-8")


def project_summary(project: dict) -> str: