Release Notes
Definition
Release notes are official documentation that accompanies each product update, informing users and stakeholders about changes in the new version. Well-written release notes are structured by change type (new features, improvements, bug fixes, deprecations, known issues), written in plain language accessible to non-technical users, and include links to relevant documentation for major changes. Release notes serve multiple audiences: end users who need to understand new capabilities, developers who need to know about API changes, and support teams who need to anticipate new questions.
Why It Matters
Release notes serve a critical communication function in reducing support volume following product updates. When users encounter unexpected changes after an update, they either contact support or churn. Proactive release notes set expectations, explain new workflows, and help users take advantage of new features. For AI chatbots, keeping release notes in the knowledge base ensures the bot can answer questions about recent changes and refer users to the appropriate version documentation, reducing post-update support spikes.
How It Works
Release notes are created by product teams, often collaborating with engineering, in a standardized template. The template typically includes: version number, release date, change categories (features, fixes, improvements), and a brief description of each change with its user benefit. For major releases, supplementary documentation like migration guides or feature announcement blog posts may be linked. Release notes are published to the product changelog page, email newsletters, and in-app notifications depending on the organization's communication strategy.
Release Notes Structure
Spring Update — Performance & Reliability
New Features
2AI-powered article suggestions in the editor
Bulk CSV export for all knowledge base articles
Improvements
3Search indexing is now 40% faster
Widget load time reduced to under 200ms
Improved mobile layout for article pages
Bug Fixes
2Fixed broken anchor links in nested articles
Resolved image upload timeout on large files
Deprecations
1Legacy v1 API endpoints removed — migrate to v2
Linked Documentation
Real-World Example
A 99helpers customer deploying an AI chatbot for a software product adds release notes to their knowledge base as part of each release process. When users ask 'What changed in the latest update?' or 'Why does X look different now?', the chatbot retrieves the relevant release notes and summarizes the key changes. This reduces post-release support tickets by 35% and improves the perceived responsiveness of the product team.
Common Mistakes
- ✕Writing release notes only for developers — end user release notes should focus on benefits and workflow changes, not code details
- ✕Publishing release notes after users have already discovered the changes — timely release is as important as content quality
- ✕Not linking release notes to related documentation — users need a path from 'what changed' to 'how to use it'
Related Terms
Changelog Article
A changelog article is a dated, cumulative record of all changes made to a product or system, organized in reverse chronological order to provide a complete history of modifications.
Knowledge Base Article
A knowledge base article is a single piece of content within a knowledge base — covering one topic, question, or procedure in depth. Articles are the atomic unit of a knowledge base, and their quality, structure, and searchability directly determine how useful the knowledge base is for both human readers and AI retrieval systems.
Content Versioning
Content versioning is the practice of tracking changes to knowledge base articles over time — storing previous versions so that edits can be reviewed, rolled back, or compared. It ensures content integrity, supports audit requirements, and enables teams to recover from accidental changes or incorrect updates.
Help Center
A help center is a publicly accessible support hub — typically branded and hosted at help.company.com — that contains the knowledge base, AI chat, and support contact options. It is the central self-service destination for customers seeking assistance, and its quality directly affects support ticket volumes and customer satisfaction.
API Documentation
API documentation is a technical reference that explains how to integrate with and use an application programming interface, including endpoints, parameters, authentication, and code examples.
Ready to build your AI chatbot?
Put these concepts into practice with 99helpers — no code required.
Start free trial →