Search posts, papers, and topics
A year‑long, donation‑funded effort by Josh Bowman‑Matthews on the Servo project resulted in 8 new maintainers, 1150 PR reviews, 114 contributor‑focused issues (92 % resolved), extensive new documentation, and concrete stability work on the JS engine integration and flaky tests, plus support for a community grant.
The essay argues that Markdown should be treated as source code and checked into a /src/md directory alongside the implementation it describes. Keeping intent in diffable, reviewable Markdown lets teams generate code and tests from it while preserving locality for both humans and AI agents.
Twilio built a two‑phase pipeline that first scores each error‑code doc with a deterministic script, then feeds only low‑scoring pages to an LLM (gpt‑5.4) using a strict prompt. The model’s diff is applied via git, linted, and opened as a PR for a reviewer. In 12 weeks they updated 1,138 pages (≈34.6 s/page) with a human reviewing every change, cutting manual effort from an estimated 18 k hours a…
Codename One replaced its Javadoc‑generated site with a Hugo‑based pipeline: a custom doclet emits one Hugo content file per Java type, preserving Markdown comments, generating a lightweight search index, and keeping the traditional offline Javadoc archive. The approach reduces index size (1.9 MB → 341 KB gzipped), retains existing anchors, and can be reused for other Java projects.
Dropbox launched a revamped API documentation site with interactive request testing, an embedded AI assistant, and a new Model Context Protocol for connecting external AI tools. The UI is unified, searchable, and includes full request/response schemas.
