2. Capture your first units

Decompose a corner of the topic and classify each piece with the decision guide.

Before you start: Scaffold your first wskill

Content lives in data/ as block instances. Pick one small corner of your topic and split it into atomic units — one idea each. Then classify each piece with the decision guide: an idea the reader must understand is a concept, a concrete named thing (a person, a tool, a file format) is an entity with a kind from schema/kinds.wcl, and a value or lookup table is a fact. Never default to entity.

Every unit gets an id, a headline, and a body { … } of wdoc blocks. Link units to each other with related = [other_id] — the projections turn those into links both ways.

§ 1Exercise: Write a concept and render it

Add a concept to data/reference/reference.wcl, then build the book and open your concept's page.

cat >> data/reference/reference.wcl <<'WCL'
concept my_first_idea {
  name    = "My first idea"
  summary = "The one-liner the index shows."
  body { p "The explanation a reader needs." }
}
WCL
wcl check wskill.wcl && wcl wdoc build wdoc/book/main.wcl --out out/book

§ 2Exercise: Classify three notes

Take three pieces of your topic — one idea, one named tool, one value table — and file each as the right kind.