Site: the developer docs (phase 4), with the Debug Builds and the Debug Console first

/dev/ has Debug Builds and the Debug Console (builds and the token, the
console and its protocol, files and screenshots, driving the UI, crashes and
Safe Mode, the command reference), Build, test and release (including how an
update works), the architecture decisions and the milestone plans.

Generated from the repository by site/tools/gen_dev_docs.py: the ADRs, the
milestones, the README's sections, and the command reference, read from the
firmware's own `help` text. The pages are committed (Zola cannot read outside
its folder); the Site workflow checks they are current, and now also runs
when src/main.cpp changes. M0, M1 and CONTEXT.md are not published.
README: the gnss commands that the table lacked.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT

site/templates/base.html

@@ -30,6 +30,7 @@
     <a href="/#apps">Apps</a>
     <a href="/install/">Install</a>
     <a href="/guide/">Guide</a>
+    <a href="/dev/">Developers</a>
     <a href="/downloads/">Downloads</a>
     <a href="/devlog/">Devlog</a>
     <button class="link-btn js-only" id="theme-toggle" type="button">Light</button>

site/templates/dev-index.html

@@ -0,0 +1,26 @@
+{% extends "base.html" %}
+{% block title %}{{ section.title }}: roro9stack{% endblock %}
+{% block description %}{{ section.description }}{% endblock %}
+{% block main %}
+<div class="wrap page">
+  <header>
+    <span class="eyebrow">{{ section.extra.eyebrow }}</span>
+    <h1>{{ section.title }}</h1>
+    <p class="lead">{{ section.description }}</p>
+  </header>
+
+  <div class="prose">{{ section.content | safe }}</div>
+
+  <div class="cards">
+    {% for path in section.subsections %}
+    {% set sub = get_section(path=path) %}
+    <article class="card n-lg{% if loop.first %} featured{% endif %}">
+      <div class="card-top"><span class="tag">{% if loop.first %}Start here{% else %}{{ sub.pages | length }} pages{% endif %}</span><span class="num">{% if loop.index < 10 %}0{% endif %}{{ loop.index }}</span></div>
+      <h2><a href="{{ sub.permalink }}">{{ sub.title }}</a></h2>
+      <p>{{ sub.description }}</p>
+      {% if loop.first %}<p class="fact">{% for p in sub.pages %}{{ p.title }}{% if not loop.last %} · {% endif %}{% endfor %}</p>{% endif %}
+    </article>
+    {% endfor %}
+  </div>
+</div>
+{% endblock main %}

site/templates/guide-page.html

@@ -1,11 +1,17 @@
 {% extends "base.html" %}
 {% block title %}{% set parent_path = page.ancestors | last %}{% set parent = get_section(path=parent_path) %}{{ page.title }}: roro9stack {% if parent_path == "_index.md" %}FAQ{% else %}{{ parent.title | lower }}{% endif %}{% endblock %}
 {% block description %}{{ page.description }}{% endblock %}
+{% block head %}
+{% if page.extra.diagrams %}
+<link rel="stylesheet" href="/css/devlog.css">
+<link rel="stylesheet" href="/css/devlog-diagrams.css">
+{% endif %}
+{% endblock %}
 {% block main %}
 {% set parent_path = page.ancestors | last %}
 {% set parent = get_section(path=parent_path) %}
 {% set screens = load_data(path="data/screens.toml", format="toml") %}
-<div class="wrap page">
+<div class="wrap page{% if page.extra.diagrams %} devlog{% endif %}">
   <header>
     <span class="eyebrow">{% if parent_path != "_index.md" %}<a href="{{ parent.permalink }}">{{ parent.title }}</a>{% else %}FAQ{% endif %}{% if page.extra.tag %} · {{ page.extra.tag }}{% endif %}</span>
     <h1>{{ page.title }}</h1>
@@ -29,7 +35,11 @@
   </nav>
   {% endif %}
 
-  <div class="prose">{{ page.content | safe }}</div>
+  <div class="prose{% if page.extra.docs %} docs{% endif %}">{{ page.content | safe }}</div>
+
+  {% if page.extra.source %}
+  <p class="muted source">This page is generated from <code>{{ page.extra.source }}</code> in <a class="accent-link" href="{{ config.extra.repo }}/src/branch/main">the repository</a>. To change it, change that file and run <code>site/tools/gen_dev_docs.py</code>.</p>
+  {% endif %}
 
   {% if page.lower or page.higher %}
   <nav class="pager" aria-label="{{ parent.title }}">