Brooklyn Nicholson
e4bda3ff77
Comment mode shipped the crop and the note, so an agent got a picture of the problem and had to grep for the element it showed. Each element comment now also names its CSS selector, its markup, and the computed styles that decide layout, which is what the agent needs to land in the right file. The target line stays prose — it is what the user pointed at — and the DOM detail rides labelled lines beneath it. Area pins have no element, so they still get only the crop and the note. Markup is redacted in the guest before it crosses to the host: password and hidden input values, and any attribute reading as a key/token/secret, are replaced with [redacted] on a clone, so a page's secrets never reach the composer or the model. It is clipped to a 600-char budget so one comment cannot paste a whole section. AnnotateIdentity was a hand-copy of CompactIdentity that had already drifted; it is now an alias, so the guest, the pin, and the packer cannot disagree about the shape again.
Website
This website is built using Docusaurus, a modern static website generator.
Installation
yarn
Local Development
yarn start
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
Build
yarn build
This command generates static content into the build directory and can be served using any static contents hosting service.
Deployment
Using SSH:
USE_SSH=true yarn deploy
Not using SSH:
GIT_USER=<Your GitHub username> yarn deploy
If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.
Diagram Linting
CI runs ascii-guard to lint docs for ASCII box diagrams. Use Mermaid (````mermaid`) or plain lists/tables instead of ASCII boxes to avoid CI failures.