The 4 Audience Tones

ShipRelay generates substantively different changelogs depending on who's reading them. This isn't a simple tone slider — each audience gets different content structure, terminology, and emphasis.

Developer

• Uses technical language: API names, method signatures, configuration flags
• Includes specific file/module references from PRs
• Groups by system area (backend, frontend, infrastructure)
• Best for: Internal engineering teams, open-source project contributors, developer documentation

User (default)

• Plain language focused on what changed from the user's perspective
• Avoids technical jargon — explains benefits, not implementation
• Focuses on features and fixes that affect the end-user experience
• Best for: Product update pages, customer-facing changelog, in-app widget

Executive

• Outcome-oriented: what business value was delivered
• High-level summary — fewer items, more context per item
• Frames changes in terms of reliability, capability, and risk reduction
• Best for: Stakeholder updates, investor reports, executive briefings

Marketing

• Confident product announcement tone
• Emphasizes new capabilities and improvements
• Structures content for external communication (blog posts, newsletters)
• Best for: Product marketing emails, social media announcements, press updates

How to use

Select the audience tone from the dropdown above the editor before generating (or regenerating) a changelog. The default is "User."