Release Notes
Added
@rwdocs/core exposes RwSite.listSections(), which returns every documentation section in one call — flat, each with its canonical ref (kind:namespace/name), scope path, and full nearest-first ancestry (root last) — so a host no longer needs N+1 getNavigation() calls to walk nested sections (which deliberately hide sub-sections as childless leaves).@rwdocs/core exposes RwSite.listPages(), which enumerates every page in a site in one pass — each with its title and its (sectionRef, subpath) key (the same pair comments use as a page's document_id) — so a host can cache human-readable page titles (e.g. for a comment inbox) without an N+1 of per-page renderPage() calls. The site's root page and virtual directory pages are included.
Changed
- Opening an inline-comment deep link (
#comment-<id>), or stepping to an inline comment with n/p, now lands the highlighted passage about a third of the way down the viewport instead of dead-center — so the passage sits where the eye rests on arrival, with room above for the comment thread.
Fixed
- Relative
.md links from a leaf page (e.g. [sibling](./other.md) in docs/specs/notif.md) now resolve to the sibling page (/specs/other) instead of a non-existent path nested under the current page (/specs/notif/other). Links now follow standard CommonMark semantics — resolved relative to the source file's directory — for both leaf pages and index.md directory pages. Links from README/index.md homepages (including the docs/ source-dir prefix case) are unchanged.
- Opening an inline-comment deep link (
#comment-<id>) no longer leaves the comment thread pinned in the wrong vertical position. The thread in the right-margin column (and the narrow-screen comment popover) could land hundreds of pixels above its highlighted passage and stay there when content above the passage reflowed after the thread was positioned — e.g. a web-font swap on first load, or a late-loading image or diagram. Threads now re-align whenever their highlighted passage moves, not only when the article is resized, so they track the highlight through any late layout shift. A normal click was never affected (it happens after the page has settled).
- The "Add comment" popover now appears when you select a line's first word by dragging right-to-left and release the mouse to the left of the article — and likewise for any text selection released outside the article body (past its right edge or below it). Previously the popover only showed when the mouse was released inside the article, so a right-to-left first-word selection silently produced nothing.
Install rw 0.1.28
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rwdocs/rw/releases/download/v0.1.28/rw-installer.sh | sh
Install prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/rwdocs/rw/releases/download/v0.1.28/rw-installer.ps1 | iex"
Install prebuilt binaries via Homebrew
brew install rwdocs/tap/rw
Download rw 0.1.28
