Package Release Post

Create professional R/Python package release blog posts following Tidyverse or Shiny blog conventions.

Quick Start

1. Identify the blog platform: Tidyverse (tidyverse.org) or Shiny (shiny.posit.co)
2. Verify NEWS.md or changelog exists for the package
3. Gather package info: name, version, repository (e.g., "tidyverse/dplyr")
4. Follow the workflow below
5. Use scripts/get_contributors.R to generate acknowledgments
6. Reference the appropriate formatting guide for final polish

Platform Selection

This skill supports two blog platforms with different formatting requirements:

• Tidyverse blog (tidyverse.org)

  • Uses hugodown
  • R packages primarily
  • More rigid structure and conventions
  • See references/tidyverse-formatting.md

• Shiny blog (shiny.posit.co)

  • Uses Quarto
  • R and Python packages
  • More flexible, feature-focused structure
  • See references/shiny-formatting.md

First, determine which platform the post is for, then follow the general workflow and apply platform-specific formatting.

General Workflow

These steps apply to both platforms. Content guidelines are based on Tidyverse best practices but adapt them as needed for Shiny posts.

Step 1: Gather Information

Collect required information:

• Platform: Tidyverse or Shiny blog?
• Package name and version: e.g., "dplyr 1.2.0" or "shiny 1.9.0"
• Repository: GitHub repo in "owner/repo" format
• Package language: R or Python
• NEWS content: Read the package's NEWS.md, CHANGELOG, or NEWS
• Package description: One-sentence core purpose
• Previous release tag: For contributor fetching (optional)
• Featured image: For frontmatter (optional but recommended)

Step 2: Structure the Post

Create the post outline following this order:

1. Frontmatter: Platform-specific YAML (see formatting references)