Round 2 (A): Brookes code page, documentation sidebar + corrections, citation policy

[mcfrank]

Part A of the round-2 feedback, against phases1to11. Templates/CSS only (plus one tiny view context addition). Design proposal: https://claude.ai/code/artifact/7a4700c1-5e9d-4d52-ba64-299ee58981c6

Brookes access-code page

• Restyled as a focused card (same pattern as login): what a code is, that it's a one-year licence per researcher, a labelled input, Apply code / Not now, and a Brookes-support link for broken codes.
• Deep link to the exact Brookes product. Brookes sells one Web-CDI access product per instrument family (listed on their CDI product page); the four chargeable families map 1:1, so brookes/utils.py maps family name → product URL, with the general Web-CDI page as fallback. Keyed by name, not pk, so it holds on the EU server's database too.
• The "Access Denied" modal (shown instead of the add-administrations dialog when the group's instrument has no live licence) gets the same copy and deep link, plus "Enter your code" and support links.
• "Not now" keeps name=cancel value=Cancel — BrookesCodeForm.clean and the view key on that value to remove the family from the researcher's list (same behaviour as the old Cancel; the footer now says so).

Documentation

• Sticky sidebar table of contents with scroll-spy on wide screens; folds to a two-column Contents card on narrow. Sections stay expanded (a manual should be readable top-to-bottom and Ctrl-F-able).
• Corrected stale UI names (Instruments page, "New administration group", Add Administrations, tick-row + Re-administer, row edit for Lab ID / opted-out, dashboard cards / group switcher, current download menu items). Added an access-code section.
• PDF link removed (per decision — it'll only drift further from the UI).
• New How to cite section.

Citations

• webcdi/_how_to_cite.html — one shared block used by About and the docs. Three explicit rules: platform → deMayo et al. (2021); CAT → Kachergis et al. (2022); instruments → Marchman, Dale & Fenson (2023) manual. Full references; DOIs verified resolving. Please eyeball the author lists — you're on two of them.

Verification

• Pages render (200) for About, docs, and code pages for a chargeable family (deep-links to its product) and a non-chargeable one (falls back to the general page).
• Code page: invalid code shows "Invalid code" with the value retained; "Not now" removes the family (tested and restored).
• Full fast suite (CI command) green alongside part B: 253 tests OK.

🤖 Generated with Claude Code