Skip to main content

Documentation draft

Author a site

Web Device documentation draft: configure, compose, and extend an existing site.

This section organizes the work of changing a site: configure site-wide behavior, compose pages and content, then extend it with components and themes. The pages state their current version boundary rather than turning incomplete contracts into a shortcut.

Read in this order

  1. Site-wide configuration for the current configuration responsibilities and legacy boundary.
  2. Compose pages and layouts for the page-level composition model.
  3. Bind content to a page for named, scoped content data.
  4. Use and override components for the beta.25 component rule and resolver order.
  5. Themes and tokens for visual values, not for an assumed theme-overlay selector.
  6. Web Device Content Markdown for content-item syntax with source and rendered-result evidence.
  7. Restrict who can read a page for collection defaults, record access, and the serve-time gate.
  8. Bookmark and note (save capability) for blocklet.yaml save:, chrome modes, and the bookmark/annotate actions.