Recipe Edition v1.0 Verification
================================

Verification of the recipe edition against the
[edition design criteria][ed] and the [recipe design decisions][rd],
conducted in Phase 11 of the [recipe edition plan][p1].

Status legend: **✓** met / **D** deferred per criteria / **→**
addressed in a later phase (linked).


Edition design criteria
-----------------------

| # | Criterion | Status | Notes |
|---|-----------|--------|-------|
| 1 | Useful, common purpose | ✓ | Recipes — broadly recognisable. |
| 2 | Clear narrow scope | ✓ | Futures list parks unit conversion, parsing, meal planning. |
| 3 | Works out of the box | ✓ | Empty edition opens to Recipe Box + Tidbits docs; five Category-tagged tag tiddlers (Breakfast/Main/Salad/Side/Dessert) ship in the empty build. |
| 4 | Self-documenting | ✓ | Ten `Tidbits: …` sections under one parent tiddler, indexed by `list` field. |
| 5 | Sample content | ✓ | `tidbits.html` includes 32 recipes, 31 ingredients, 63 photo tiddlers, 1 system config. |
| 6 | Complexity ceiling (~1k words) | ✓ | 998 words across the Tidbits sections (trimmed from 1,026 during this verification). |
| 7 | Customizations easy / L10n-friendly | ✓ | Palette colours throughout the stylesheet; user-facing strings in dedicated tiddlers; Control Panel tab. Template-internal English UI strings deepen this in [Phase 12][p1] (Tier 1) and tag-name / section-heading parameterization in [Phase 13][p1] (Tier 2 scope review). |
| 8 | Showcase idiomatic TW | ✓ | `<% if %>`, `<<list-links>>`, ConfigPanel pattern, view-template cascades, palette colours, edit-template cascade. |
| 9 | Maintainable | ✓ | Three small custom JS modules (phone-home stub, wake-lock, action-attach-photo); rest is wikitext + pinned plugins. |
| 10 | Namespace conventions | ✓ | Edition tiddlers under `$:/community/recipes/`. |
| 11 | Modern TW techniques | ✓ | `<% if %>`, `\procedure`, `\parameters`, conditional shortcut. |
| 12 | Deployment-agnostic | ✓ | Single-file HTML build via `--build empty`; tiddlyweb/filesystem are dev-only via the build profile. Custom JS guarded for browser context. |


Decisions
---------

| Decision | Status | Notes |
|----------|--------|-------|
| Documentation lives inside each artifact | ✓ | Tidbits sections are part of the source; baked into both empty and populated builds. |
| Empty + content collection | ✓ | `tidbits_empty.html`, `tidbits.html` (built from empty + JSON sample collections). |
| Reset method for demo content | ✓ | `RemoveDemoContent` UI selectively deletes `[field:demo[yes]]` tiddlers. 65 US-recipe + 62 ingredient + 1 system tiddler all carry `demo:yes`; categories handled separately. |
| Full i18n not primary | D | RTL, locale numbers, plurals deferred per criteria. |
| Critical deps bundled, phone-home stub | ✓ | Relink + AutoComplete bundled; phone-home stub gated by config tiddler (default off). |


Recipe-specific decisions
-------------------------

All ✓: ingredient/step representation, plugin bundle (Relink +
AutoComplete; uni-link removed), no locale logic, `demo: yes`
field-based isolation, two-mode reading view (normal +
cooking-mode), photo tiddler convention `<Title> (photo)` with
embed-or-`_canonical_uri` and attribution captions, ingredient
aliasing via `aliases` field with custom missing-tiddler hint and
view template.


Phase 10 dev-scaffolding cleanup
--------------------------------

| Item | Status |
|------|--------|
| `$:/DefaultTiddlers` | ✓ `[[Recipe Box]] [[Tidbits: About]]` |
| `$:/StoryList` | ✓ Empty in source; `reset-storylist.js` wired into prebuild and postbuild |
| `$:/config/DefaultMoreSidebarTab` | ✓ `$:/core/ui/MoreSideBar/All` |
| `$:/config/DefaultSidebarTab` | ✓ `TableOfContents` (kept as release default) |
| `Some Recipe.tid` | ✓ Absent |
| `tiddlywiki.info` description | ✓ Updated from boilerplate during this verification |


Compat metadata
---------------

| Field | Value |
|-------|-------|
| `min-tw-core` | 5.3.6 (empirically verified) |
| `min-version-verified` | yes |
| `tested-versions` | 5.3.6 |
| Bundled in release artifact | TW core 5.3.6, Relink 2.5.3, AutoComplete 1.0.24 |

5.3.0 was found empirically broken (offline-save artifact fails to
render).  Bisection of 5.3.1–5.3.5 was not pursued — for an edition
that embeds its TW core in the release artifact, the min-version is
consumed by the editions tool's phone-home check rather than by end
users picking a core to install against.


Cross-browser / mobile spot checks
----------------------------------

| Platform | Engine | Result |
|----------|--------|--------|
| Brave on Windows (desktop) | Blink (Chromium) | ✓ |
| Chrome on Windows (desktop) | Blink | ✓ |
| Brave on Android | Blink | ✓ |
| Firefox on Windows (desktop) | Gecko | pending |
| Chrome on Android | Blink | pending |
| Firefox on Android | Gecko | pending |
| Safari on iOS / macOS | WebKit | not covered (no hardware available) |

WebKit / iOS Safari coverage is a known gap.  The edition uses
standard CSS Grid, Flexbox, media queries, and `aspect-ratio` (iOS
Safari ≥ 15.0); no WebKit-specific risks identified by code review.
Wake Lock unavailability on iOS `file://` is already documented in
[[Tidbits: Reading and cooking]].  Plan: solicit iOS feedback when
the edition is posted to the TW forum and address any reported
issues post-1.0.


Items addressed in later phases
-------------------------------

| Item | Tracked under |
|------|---------------|
| Empty-edition sample-data download URL (placeholder) | [Phase 11a][p1] — GitHub Pages hosting |
| Template-internal English UI strings | [Phase 12][p1] — Tier 1 localization |
| Configurable tag names and section heading parsing | [Phase 13][p1] — Tier 2 scope review |
| Final release prep (version bump, smoke-test, publish) | [Phase 14][p1] |


Items addressed during this verification
----------------------------------------

  - `tiddlywiki.info` description string updated from boilerplate
    to a meaningful edition description.
  - Tidbits prose tightened from 1,026 → 998 words (Customizing
    and Reading-and-cooking sections).
  - Compat tiddler floor empirically verified and pinned to 5.3.6;
    `min-version-verified: yes`.


  [ed]: 001-edition-design.md
  [rd]: 002-recipe-design.md
  [p1]: ../plans/001-recipe-edition.md
