Home / How-to guides

How-to guides

One task each, in the order a site adopts the API. The newsroom's pages are the worked examples throughout; its repository is public.

• Add the meter to a page: the element, the config, the import, the balance chip, the account pages, and the two data files your site publishes.
• Make a reading-list link: by hand from the grammar, or with the make page; what the recipient sees.
• Open the newsroom as a persona: persona pages and links, persona/links.json, what a visitor persona is.
• Set up the subscribe lane: a key pair, a vault on an SG/Send host, the contact file at /.well-known/, and reading the lane with the key alone.
• Take a release, roll one back: for a site that consumes the API; the newsroom's procedure as the example.
• Run the tests: in Chromium, WebKit and Firefox, against the newsroom's pages or your own.
• Make a release: for maintainers: version, cut, check, pull request, deploy, the live check.