Blank section template¶

Copy the block below into docs/sections/NN-your-topic.md, then add a line to the nav array in zensical.toml:

{ "11. Your topic" = "sections/11-your-topic.md" },

The preview server picks up both changes without a restart.

The template¶

---
icon: lucide/circle
---

# NN. Section title

<div class="section-meta" markdown>
<b>Filled by</b> Client &nbsp;·&nbsp;
<b>Questions</b> 0 &nbsp;·&nbsp;
<b>Time</b> ~0 min &nbsp;·&nbsp;
<b>Prefix</b> <code>xxx_*</code>
</div>

One or two sentences on what this section is for and why it comes at this point
in the questionnaire. If any answer here changes what a later section does, say
so here.

## NN.1 Subsection title

| ID | Question | Type | Options / units | Req. |
|----|----------|------|-----------------|------|
| `xxx_field_one` | Question text as the client reads it? | Single choice | Option A / Option B / Option C | Yes |
| `xxx_field_two` | Follow-up question? | Long text | — | Cond. |

`xxx_field_two` → if `xxx_field_one` = Option A

!!! tip "Coach note"

    Guidance for whoever reads the answers — what to look for, what it changes
    in the programme. Delete if there's nothing useful to say.

## NN.2 Subsection title

| ID | Question | Type | Options / units | Req. |
|----|----------|------|-----------------|------|
| `xxx_field_three` | Question text? | Multi-select | One / Two / Three / None of these | No |

## NN.N Red flags

<!-- Only add this subsection if this section's own fields actually drive a
     red flag. Delete it entirely if none do — see "Adding the Red flags
     subsection" below for how to decide, and 06-goals.md /
     10-preferences-logistics.md for sections that correctly have none. -->

---

**Previous:** NN-1. Previous section ·
**Next:** NN+1. Next section

Adding the Red flags subsection¶

Not every section gets one, and no two that have one look the same. Each section's Red flags subsection carries only the entries whose trigger field lives on that page — filtered by judgement, not copied wholesale from Screening red flags.

To add it to a new section:

1. Read Screening red flags, and check which of its stop, clearance, caution and age-and-load items are actually driven by an answer on this section's page — by field ID, not by loose thematic overlap.
2. If none are, don't add the subsection at all. An empty or irrelevant Red flags block is worse than none — it trains whoever reads it to skim past the heading.
3. If some are, write them in the same format used elsewhere: bullets for Stop and refer immediately / Clearance required, a Flag | Source field | Typical modification table for Proceed with caution. Cite the field ID inline, same as the source page does.
4. Where a rule depends on fields from more than one section — age-and-load is the clearest example, needing client_dob plus fields from two other sections — put the substantive version where its primary field lives and leave a one- or two-line cross-reference on the others, rather than repeating the full table. See 1.6 for the primary copy and 5.3 for a cross-reference example.
5. Renumber the heading to the next number on your new page.

Checklist for a new section¶

• Every field ID uses the section's prefix and is unique across the whole questionnaire
• Every Type value comes from Question patterns
• Conditional questions are marked Cond. and have a → rule under the table
• Multi-selects include an escape option (why)
• Sensitive questions are optional, offer Prefer not to say, and carry a handling admonition
• Nothing is asked twice — cross-reference the existing field instead
• A Red flags subsection is added only if this section's own fields drive one, filtered by field ID, not copied wholesale — see Adding the Red flags subsection
• The question count and time estimate in section-meta are updated
• The Previous/Next placeholders at the foot are turned into real links — [6. Goals & motivation](06-goals.md), relative to docs/sections/ — and the neighbouring pages point back
• The section is added to nav in zensical.toml
• The table in the overview has a row for it

Available icons¶

Set one in the page's front matter — it shows in the navigation. Any Lucide name works as lucide/<name>. The ones already in use: