Commit d6a9f08
committed
site: code blocks become generated-snippet placeholders
Fifteen hand-written code blocks across three pages become
`<pre class="example-code" data-snippet="<id>"></pre>`, filled at deploy time from
the payload the MetaObjects repo builds and gates. Eleven on index.html, two on
requirements.html, two on the prompts article — exactly the fifteen ids in that
repo's snippet registry, which is where they were read from rather than typed.
DO NOT PUSH YET. The deploy step that fills them does not exist until the next
task, so these pages would go live with fifteen empty blocks.
Two blocks on index.html stay hand-written, correctly: the assess.md prompt is
something the reader pastes, and the CLI-commands block is shell. That second one
did carry a real error, now fixed — `meta migrate --db … --slug …` under a comment
claiming it diffs the live DB. Without `--from-db` it diffs the committed
snapshot, so the comment described a run the flags did not make; it is now the
CLI's own documented greenfield example.
Prose that the real snippets invalidated:
- The five-language section's per-language labels each promised more than the
block shows — one file is not the whole generated set. Each now names the file
and says what else the same run emits.
- "Spring REST + DTO + JPA" for Java, in the Codegen pillar card and the example
intro. codegen-spring emits DTOs, controllers and repository interfaces; there
is no `@Entity` and no jakarta.persistence anywhere in the module, and the
site's own llms.txt already said "the persistence impl is consumer-supplied".
- "The metamodel goes deep" ran on a fictional `blog` package. It is
`acme::learn` from examples/advanced-modeling now, so Post becomes Program and
AuthorSummary becomes ProgramSummary. The marked source region is Author and
its validators, so the label says that rather than promising a projection the
block does not contain.
- requirements.html's ledger entry was `arena::Bot.status`, introduced as "a real
entry from a live product, and it is wrong". The block is now the showcase's
own entry, which resolves and is gated — so it can demonstrate "resolved, not
trusted" instead of asserting it. The live-product finding is the strongest
thing on the page and is kept, told as what it now is: a near-identical entry
that passed every structural check and was still wrong. That is the sharper
argument anyway — the check is necessary and not sufficient.
- The generated test stub lands beside "what you get, and what you build", where
the page says a stub is a place to put a proof and not a proof. It carries the
TypeScript-only caveat next to it.
Palette: `.example-code .ok/.err` for terminal blocks (transcripts would have
shipped unstyled), and `.example-details` for the expander the injector appends —
new markup this site has never carried, so the browser default was the only thing
styling it. The per-page `tok-*` rules are dropped where their only users were the
blocks now injected; `requirements.html` keeps `.tok-err`, which is still used in
prose outside any `<pre>`.
llms.txt and llms-full.txt are re-copied wholesale from the monorepo's docs/llms/,
which is what they mirror. They carried the fifth pillar and were also four minor
lines stale — still describing generators as package imports rather than the
scaffold-and-own copies getting-started.html now documents.1 parent 3e9a234 commit d6a9f08
6 files changed
Lines changed: 139 additions & 289 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
45 | 45 | | |
46 | 46 | | |
47 | 47 | | |
48 | | - | |
49 | | - | |
50 | | - | |
51 | | - | |
52 | | - | |
53 | 48 | | |
54 | 49 | | |
55 | 50 | | |
| |||
136 | 131 | | |
137 | 132 | | |
138 | 133 | | |
139 | | - | |
| 134 | + | |
140 | 135 | | |
141 | | - | |
142 | | - | |
143 | | - | |
144 | | - | |
145 | | - | |
146 | | - | |
147 | | - | |
148 | | - | |
149 | | - | |
150 | | - | |
151 | | - | |
| 136 | + | |
152 | 137 | | |
153 | 138 | | |
154 | 139 | | |
155 | | - | |
| 140 | + | |
156 | 141 | | |
157 | | - | |
158 | | - | |
159 | | - | |
| 142 | + | |
160 | 143 | | |
161 | 144 | | |
162 | 145 | | |
| |||
0 commit comments