lifecycle
lifecycle gave the tidyverse the word superseded, then spent years tuning who gets warned
Comparison · Infra & APIs
pkgdown vs roxygen2
A side-by-side editorial comparison of pkgdown and roxygen2 — release velocity, themes, recent moves, and the top alternatives to consider.
Shared themes:documentation
pkgdown vs roxygen2: at a glance
What is pkgdown?
pkgdown now generates llms.txt and a markdown copy of every documentation page
pkgdown builds the documentation sites for most R packages. The 2.1 line was about format and appearance - Quarto vignettes, a light and dark switch, self-hosted assets instead of CDN fetches. The 2.2 line changed audience: build_llm_docs() emits an llms.txt at the site root and a markdown version of every page, on by default.
What is roxygen2?
roxygen2 8.0 cut stringi out of the entire devtools dependency tree.
roxygen2 turns inline comments into R documentation and NAMESPACE files. The 8.0.0 release was as much about dependencies as features: dropping purrr, stringr and stringi means nothing in the devtools constellation pulls in stringi, long a persistent install obstacle on constrained Linux systems. 8.1.0 follows with markdown correctness work and cached link resolution.
pkgdown vs roxygen2: editorial side-by-side
pkgdown
0.0INFRA · APIS
pkgdown now generates llms.txt and a markdown copy of every documentation page
◆ Current state
pkgdown builds the documentation sites for most R packages. The 2.1 line was about format and appearance - Quarto vignettes, a light and dark switch, self-hosted assets instead of CDN fetches. The 2.2 line changed audience: build_llm_docs() emits an llms.txt at the site root and a markdown version of every page, on by default.
◆ Where it's heading
Two audiences are now being served from one build. Human-facing work continues in small increments - dark-mode plot filtering, new translations, a local http server so search works in preview - while the new machine-facing output is opt-out rather than opt-in. The default matters more than the feature: thousands of package sites will start emitting llms.txt without their maintainers choosing to.
◆ Prediction
Expect the markdown output to gain the same configuration surface the HTML has, and the llms.txt contents to get more selective as maintainers discover what ends up in it; a way to exclude individual pages is the obvious next request.
roxygen2
2.5INFRA · APIS
roxygen2 8.0 cut stringi out of the entire devtools dependency tree.
◆ Current state
roxygen2 turns inline comments into R documentation and NAMESPACE files. The 8.0.0 release was as much about dependencies as features: dropping purrr, stringr and stringi means nothing in the devtools constellation pulls in stringi, long a persistent install obstacle on constrained Linux systems. 8.1.0 follows with markdown correctness work and cached link resolution.
◆ Where it's heading
The package is investing in the documentation toolchain beneath it — a new rdtools package supplies cached indexes so link targets and inherited Rd topics resolve without repeated help() lookups. Running alongside is steady correction of markdown handling, where multibyte characters inside Rd tags had been corrupting everything that followed.
◆ Prediction
Expect more Rd processing to migrate into rdtools, and further link-resolution changes now that all generated links share a single code path.
Alternatives to pkgdown and roxygen2
Other Infra & APIs products tracked by Sparkpulse, ranked by recent ship velocity. Each card links to a full editorial trajectory and lets you pivot into a head-to-head comparison with either pkgdown or roxygen2.
waldo
waldo keeps shedding dependencies while teaching its diff engine new object systems
usethis
usethis swaps in the Air formatter and stops assuming RStudio is the editor
knitr
knitr adds OpenTelemetry tracing, turning document builds into observable pipelines
lintr
lintr makes the native pipe the default rule and clears out a decade of deprecations
covr
covr's coverage tooling has been stable to the point of dormancy since 2022
See all pkgdown alternatives → · See all roxygen2 alternatives →
Recent activity from pkgdown and roxygen2
Latest ship moves from both products, interleaved chronologically. ⚡ = editorial spark.
- 8d agoroxygen2roxygen2 8.1.0 resolves links via cached rdtools indexes
- 1mo agopkgdownLocal preview served over http so search works
- 3mo agoroxygen2roxygen2 8.0.0 drops stringi from the devtools dependency chain ⚡
- 9mo agopkgdownbuild_llm_docs() emits llms.txt and markdown for every page ⚡
- 11mo agoroxygen2roxygen2 7.3.3 auto-resolves markdown links to external topics
- 1y agopkgdownMenu items accept class and id attributes
- 1y agopkgdownROR IDs, Codeberg support, bslib navbar variables
- 1y agopkgdownKeyboard shortcut for search; clean_cache() added
- 2y agopkgdownQuarto vignettes, light/dark switch, self-hosted assets
- 2y agoroxygen2roxygen2 7.3.2 disables cli hyperlinks in included Rmd
- 2y agoroxygen2roxygen2 7.3.1 fixes @importFrom for quoted non-syntactic names
- 2y agoroxygen2roxygen2 7.3.0 reports S3 methods missing @export
Frequently asked questions
What is the difference between pkgdown and roxygen2?
Both compete on the same themes — documentation — within Infra & APIs. roxygen2 is currently shipping more aggressively (velocity 2.5 vs 0.0), with 0 editorial sparks in the last 30 days against 0. See the at-a-glance table above for a side-by-side breakdown of velocity, recent sparks, and editorial themes.
Is pkgdown better than roxygen2?
Sparkpulse doesn't pick a winner — we score release velocity, not feature parity. roxygen2 is currently shipping more aggressively (velocity 2.5 vs 0.0), with 0 editorial sparks in the last 30 days against 0. For your specific use case, the alternatives sections above list other Infra & APIs products to evaluate alongside.
What are the best alternatives to pkgdown?
Top pkgdown alternatives in Infra & APIs are ranked by recent ship velocity. Browse the "pkgdown alternatives" section above for the current picks, or visit /alternatives/pkgdown for the full list with editorial commentary on each.
What are the best alternatives to roxygen2?
Top roxygen2 alternatives in Infra & APIs are ranked by recent ship velocity. Browse the "roxygen2 alternatives" section above for the current picks, or visit /alternatives/roxygen2 for the full list with editorial commentary on each.