Archetype: doc_facet.org.mustache

{{! GENERATED FILE — tangled from projects/ores.codegen/library/templates/doc.org. Edit the org source. }}
:PROPERTIES:
:ID: {{id}}
:END:
#+title: {{title}}
#+description: {{description}}
#+type: facet
#+level: cross
#+facet_group: {{facet_group}}
#+filetags: {{filetags}}
#+created: {{date}}
#+updated: {{date}}

This page is the literate source for the ={{slug}}= facet of the
codegen template library. Each section documents one template and
holds its source in a =mustache= block tangled to the sibling
=.mustache= file consumed by =generator.py=. The =.mustache= files are
generated artefacts — edit this document, then run the tangle
(=compass build --direct tangle_codegen_templates= or
=projects/ores.lisp/src/ores-build-codegen-templates.el= directly).
Output paths and profile membership come from
[[id:A8145FD7-0651-40FD-857E-BC37C9320020][facet_catalogue.org]].

* Summary

(Three to five sentences: which templates this facet owns, what they
generate, and which profiles consume them.)

* The {{slug}} facet

(What this facet projects the model onto, in MASD terms: link to the
MASD modeling docs, name the model element it consumes — entity or
component — and explain the facet's shape: why these templates exist
and how they relate to each other.)

* Mustache incantations

(Document the Mustache constructs the templates rely on — sections,
escaped vs triple-stache interpolation, comments — where they are not
obvious. Delete this section if the facet only uses constructs
already covered by its group doc.)

* Templates

(One subheading per template: prose covering role, model inputs,
output artefact and profiles, followed by the source block. The first
line of every block is the output-neutral GENERATED FILE header:)

#+begin_example
,#+begin_src mustache :tangle <name>.mustache
{{=<< >>=}}{{! GENERATED FILE — tangled from <path to this doc>. Edit the org source. }}<<={{ }}=>>
...template source...
,#+end_src
#+end_example

* See also

- (Parent template group doc: =<group>_group.org=.)
- [[id:3B6B9F75-BDC9-4AE9-B16E-5A05FFC3A4B5][Codegen template library]] — the groups overview.
- [[id:A8145FD7-0651-40FD-857E-BC37C9320020][facet_catalogue.org]] — profile → template/output mapping.