Editorial maintenance
Changelog
A plain log of editorial maintenance. Pages are revised when the framing improves, when wording can be cleaner, or when a related book or practice page is added.
This page records editorial maintenance to the library. The notes are deliberately broad. They record what changed and why, without trying to read like a press release. Material changes to privacy, terms, or wellbeing wording are flagged here so that readers can see when something on those pages has been adjusted.
The list is grouped loosely by quarter. Smaller corrections, typo fixes, and minor link updates are not listed individually.
Recent maintenance
Wider library
- Several wiki guides were tightened. Repeated phrasing was cut, sentence rhythm was rebalanced, and a small number of bullet lists were converted to prose where prose worked better.
- The internal linking inside Tier B guides was reviewed. Some related-reading lists were trimmed; others were expanded where the connection genuinely helped the reader.
- Headings across the library were checked for descriptiveness. A handful of generic "Overview" and "Why it matters" headings were rewritten to point at the actual question being answered.
- The site search index now indexes the full body of guides, book notes, ideas, and practices, with global components excluded so that footer and navigation links do not pollute the results.
Wellbeing pages
- The opening note on the social anxiety, depression, and anxiety mouse pages was reviewed for tone. The wording is now slightly calmer and more clearly educational rather than diagnostic.
- The depression page had an internal link tidied so that the related-reading section follows the same structure as the other wellbeing pages.
- The lonely birthday topic page was given a quieter image treatment.
Book notes
- A small editorial pass added two or three sentences of context to the book notes on Co-opetition, Doughnut Economics, and Mastering the Market Cycle, where the standalone framing was a little thin.
- The AI Superpowers note was reviewed and lightly tightened. The page is one of the most-read on the shelf and benefits from a careful edit.
- Related-reading sections at the bottom of book notes were standardised to the new format.
Practices
- The vulnerability check was reworded so that the prompts are slightly more concrete. The previous version was too abstract for some readers.
- The purpose worksheet was reordered. Constraints now come before values; in practice that order tends to produce a more honest answer.
Design and accessibility
- The overlay menu now respects reduced-motion preferences and does not animate when the user has expressed a preference for less movement.
- Hero images were given explicit width and height attributes to reduce layout shift on slower connections.
- Typography on smaller screens was adjusted so that the lede paragraphs no longer crowd the headings.
- Skip-to-content link is now visible on focus and skips reliably to the main content area.
Search
- The local search now ranks title matches above body matches and shows a short snippet centred on the matched word.
- The search index is rebuilt as part of the production build, so newly published pages appear without manual updates.
Older maintenance
A summary of older editorial activity, kept brief.
- Book-note shelf reorganised into reading clusters rather than alphabetical order.
- Wiki guides on habits and happiness were given longer practice sections.
- The relationships hub was added as a small, separate landing for the vulnerability and communication guides.
- The wellbeing hub was added as a small, separate landing for the more careful pages.
- Several practice pages had their length reduced, on the principle that a fifteen-minute exercise should fit a fifteen-minute slot.
- Internal navigation was simplified. Footer links are now internal only.
How decisions are made
A note on what tends to drive a revision.
- A reader flags a sentence that reads awkwardly. The editors usually agree, and the page is revised.
- A reader flags a fact that is wrong or out of date. The page is corrected, and where the source was a study, the citation is reviewed.
- A new book note unlocks a better related-reading section on an existing page. The earlier page gets a small update.
- A page has been read for several months and a clearer way of saying the central idea has emerged. The page is rewritten or partially rewritten.
- A topic was treated too thinly when the page was first written. The page is expanded or split into two pages.
What this page does not record
- Typo fixes.
- Image filename changes.
- Internal markup adjustments.
- Wording tweaks that do not change the substance of a paragraph.
- Image manifest updates.
If you would like to flag a correction or suggest a revision, the contact page explains how. The library is small enough that real corrections actually get made.