Release Notes
Added
mtimeSource: "filesystem" | "git" option on @rwdocs/core's createSite() (default "filesystem") — "git" reports commit-based times matching S3-served pages; "filesystem" uses a fast stat.@rwdocs/core's renderPage/getNavigation (and the matching rw serve responses) now return a sectionAncestry map — each connected section's ref mapped to its nearest-first ancestry chain — so a host resolves a page's full section context in one call. Purely additive.@rwdocs/core's RwSite.listPages() entries now carry a lastModified RFC-3339 timestamp, so a host can sort pages by recency without rendering each one. Legacy S3 manifests report the Unix epoch until republished.rw update self-updates the installed binary from the latest GitHub release (--check, --version <x.y.z>, --prerelease). Only shell/PowerShell installs self-update; Homebrew, npm, cargo, and source builds print upgrade guidance instead.
Changed
- Breaking (pre-1.0):
@rwdocs/core's renderPage/getNavigation responses (and the viewer) replace the breadcrumb section object with flat sectionRef/subpath fields.
rw serve now reports page lastModified from the filesystem mtime instead of the git commit time, dropping a per-request git walk. Published bundles and S3-served pages keep git-commit times.- The
rw serve page ETag now covers the whole response, not just the HTML, so a page revalidates when its section identity or ancestry changes. If-None-Match still returns 304 when nothing changed.
Fixed
- Internal links no longer build doubled or wrong paths when the viewer is embedded (e.g. in Backstage): a link pointing above the current entity's scope now resolves against the nearest host-mapped ancestor instead of concatenating onto the current base. Consequently the top "Home" breadcrumb in a nested sub-entity navigates to the root entity's docs.
Install rw 0.1.30
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rwdocs/rw/releases/download/v0.1.30/rw-installer.sh | sh
Install prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/rwdocs/rw/releases/download/v0.1.30/rw-installer.ps1 | iex"
Install prebuilt binaries via Homebrew
brew install rwdocs/tap/rw
Download rw 0.1.30
