Skip to main content

​
Release Notes Taxonomy

Standardized tags, components, and classifications for consistent release note organization.

​
Tags (Required)

Choose 1-3 tags per release. First tag should be primary category.

​
Primary Categories

TagUse WhenExample
featureBrand new functionality”Added beat request system”
improvementEnhancement to existing feature”Faster dashboard loading”
bugfixResolved issue or bug”Fixed login error”
securitySecurity-related change”Fixed XSS vulnerability”
performanceSpeed/efficiency optimization”Reduced API response time”
deprecationFeature being removed”Deprecated old API endpoint”
infrastructureBackend/ops changes”Database migration”
designUI/UX changes”Redesigned player”

​
Secondary Tags

TagUse When
breakingChanges break existing behavior
mobileMobile-specific changes
apiAPI-related changes
analyticsAnalytics/tracking changes

​
Components (Optional)

Specify which platform areas are affected.

​
User-Facing Components

  • billing — Payments, subscriptions, invoices
  • producer-dashboard — Producer analytics and management
  • track-upload — Upload flow and processing
  • player — Audio/video player
  • messaging — Chat and notifications
  • artist-profile — Artist/producer profiles
  • beat-requests — Request system
  • licensing — License management
  • search — Search functionality
  • playlists — Playlist features
  • social — Following, sharing, engagement

​
System Components

  • authentication — Login, signup, auth flows
  • api — Backend APIs
  • database — Data storage changes
  • cache — Caching layer
  • notifications — Email, push, in-app
  • analytics-backend — Internal analytics
  • admin — Admin panel
  • stripe-connect — Producer payouts

​
Audience

Who needs to know about this release?
AudienceWhen to Use
AllAffects everyone (default for most releases)
ProducersOnly affects beat producers
ArtistsOnly affects artists/listeners
AdminsOnly internal admin tools
DevelopersAPI changes, technical updates

​
Decision Guide

Does it affect the public website/app?
├── Yes → Does it affect producers?
│   ├── Yes → "All" or "Producers"
│   └── No → "Artists"
└── No → Is it admin-only?
    ├── Yes → "Admins"
    └── No → "Developers"

​
Severity

Impact level of the release.
SeverityDescriptionExample
majorSignificant new features, breaking changesNew producer dashboard
minorNew features, no breaking changesAdded beat requests
patchBug fixes, small improvementsFixed mobile player
hotfixCritical fix requiring immediate deploymentSecurity patch

​
Status

Publication workflow state.
StatusMeaning
draftWork in progress, not ready
reviewPending review
publishedLive and public
archivedOld release, superseded

​
Examples

​
Feature Release

tags: ["feature", "producers"]
components: ["beat-requests", "producer-dashboard"]
audience: "Producers"
severity: "minor"

​
Bug Fix

tags: ["bugfix", "mobile"]
components: ["player", "messaging"]
audience: "All"
severity: "patch"

​
Security Update

tags: ["security"]
components: ["authentication", "api"]
audience: "All"
severity: "hotfix"

​
Validation Rules

  • Must have at least 1 tag
  • Must have exactly 1 audience
  • Must have exactly 1 severity
  • Tags must be from approved list
  • Components must be from approved list
This taxonomy is versioned. Updates require approval and documentation of changes.
Last modified on February 6, 2026