Skip to main content

Documentation draft

Publish and maintain

Web Device documentation draft: preview, build, publish, check, and diagnose a site.

This section explains a site's path through local preview, build, formal publishing, ongoing checks, and diagnosis when something fails. Local direct runs are the default acceptance path; formal deployment is a separate, explicitly requested surface.

Read in this order

  1. Preview, build, and publish to distinguish a direct local run, a build artifact, and formal deployment.
  2. In-page review mode to leave text-anchored feedback on the rendered page next to the content item.
  3. Bookmark and note (save capability) for reader bookmark/note chrome (not review). Declaration lives on blocklet.yaml.
  4. SEO, links, and accessibility to separate static checks from reader-facing acceptance.
  5. Diagnose a site to narrow a failure before changing source or deploying anything.