Splitting one prompt in two renumbered every step after the cut
We split one long numbered prompt into two. Every step after the cut changed number, and the sentences that navigate by those numbers went on pointing at whatever now wore them.
Shipping notes, in public
How we build the thing that publishes your changelog, your blog and your release notes.
The changelog entry nobody reads: the one that leads with "we"
Entries that open with "we've added" put the team in the subject position and leave the reader to translate. The repair is grammatical: make the thing the reader controls the subject of the sentence, and delete the team from it.
An API changelog: what consumers need that users do not
A product changelog is read by people who will see the change on screen. An API changelog is read by people whose code will stop working, and that audience needs the symbol name, the date and a feed a machine can poll.
Writing documentation an assistant can quote correctly
An assistant quotes a passage, not a page. Docs that survive that treatment answer in the first sentence, restate their own subject, and name exact values instead of gesturing at them.
Tracking clicks to your own documentation in GA4
Whether GA4 records a click to your docs depends on where the docs live. The built-in outbound click event fires only for links that lead away from the current domain, and configuring cross-domain measurement switches it off again.