rstudio-populate-whats-new

Generates the RStudio Desktop What's New page from NEWS.md release entries.

5.0k|1.2k|Updated Dec 7, 2010
One-click install
npx skills add https://github.com/rstudio/rstudio --skill rstudio-populate-whats-new
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rstudio-populate-whats-new
Source: https://github.com/rstudio/rstudio/tree/main/.claude/skills/rstudio-populate-whats-new
Command: npx skills add https://github.com/rstudio/rstudio --skill rstudio-populate-whats-new

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Each RStudio Desktop release ships a "What's New" page shown on first launch, and turning the raw NEWS.md changelog into user-facing HTML content requires editorial judgment about which entries matter to Desktop users, plus correct HTML structure, escaping, and validation.

Core Features & Use Cases

  • Entry Selection: Filters NEWS.md entries down to features and enhancements relevant to RStudio Desktop end users, excluding server administration, build tooling, and ordinary bug fixes.
  • HTML Authoring: Writes the release page at src/node/desktop/src/assets/whats-new/<release-slug>/index.html following the established style of prior releases, with correct escaping, CSP-safe head tags, and the standard Fixes section linking to release notes.
  • Verification and PR Workflow: Runs the desktop npm test suite (including whats-new content validation), commits with a conventional message, and opens a PR with the correct milestone.
  • Use Case: After the release branch is cut, ask the assistant to populate the What's New page for the current release; it reads NEWS.md, selects and writes the entries, validates them, and opens the PR.

Quick Start

Populate the What's New page for the current RStudio release from NEWS.md and open a pull request.

Frequently Asked Questions about rstudio-populate-whats-new

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I populate the RStudio What's New page for a release?

Read the current release's NEWS.md, select features and enhancements relevant to Desktop users, and write them into src/node/desktop/src/assets/whats-new/<release-slug>/index.html following prior releases' style. Then run the desktop npm tests and open a PR.

Which NEWS.md entries belong on the What's New page?

Include new features, enhancements, and user-visible deprecations or renames that RStudio Desktop end users care about. Exclude server administration options, build and CI tooling, and ordinary bug fixes, which are covered by the linked release notes.

Where is the What's New content stored in the RStudio repository?

Each release has a directory under src/node/desktop/src/assets/whats-new/ named by the slugified release flower name from version/RELEASE, containing an index.html file. The README.md in that directory documents the required structure and CSS classes.

How do I preview the What's New page in RStudio Desktop?

Launch RStudio Desktop with the RSTUDIO_SHOW_WHATS_NEW=1 environment variable, or use Help > What's New in a running IDE. A developer build reads the release name from version/RELEASE to show the in-progress release's page.

Why does the whats-new content validation test fail?

The test checks that every release page contains the required head tags, including the Content-Security-Policy meta tag and the whats-new-base.css link. Failures usually mean the head section was modified or required elements were removed.