The Challenge

Omega 365 evolves every day. New features are rolled out, bugs are addressed, and user feedback drives constant refinement. While this dynamic approach ensures that our platform meets our customers' needs, it also presents a challenge: how do we communicate these changes in a way that is accessible, consistent, and valuable for end-users?

Manually drafting release notes for daily updates as time-consuming and error-prone. We needed a system that could scale with our development cycles and ensure quality, all while saving time for our team.

The AI-Powered Solution

To tackle this, we integrated AI into our release note generation process. Using ChatGPT, we automated the creation of concise and user-friendly summaries of the changes made in Omega 365. Here’s how it works:

1. Centralized Data Source: All feature requests, bug reports, and updates are documented in workflows within Omega 365. This ensures that all relevant information, including titles, descriptions, and solutions, is well-organized and accessible.

2. JSON-Based Input: For each update, we provide ChatGPT with a structured JSON containing:

   • A title and description, representing the original input from users.
   • A solution property, added by developers once an issue or request is resolved.
   • A process type to indicate whether it’s a bug fix or a new feature.

3. Clear Instructions: ChatGPT is guided by precise instructions to:

   • Summarize updates in plain, non-technical language suitable for release notes.
   • Omit any sensitive information, such as client or project names.
   • Focus on what has changed, why, and how it benefits the user.

4. Daily Updates, Seamlessly Communicated: With this setup, we can generate release notes that are brief, to the point, and always relevant to our customers.

The Challenges

While introducing AI to generate release notes was a game-changer, the journey wasn’t without its hurdles. In the early stages, our automated notes were over the top. They tended to be too detailed, sometimes veering into unnecessary technical jargon or overly lengthy explanations. In other cases, the tone felt too promotional, almost as though we were bragging about every little improvement. However, this was easy to adjust. The AI generated release notes can be configured:

Using the setting "Chart cequest system message" we instruct AI how the response to be. And by simply adding "...and be to the point - what has changed, or what has fixed, and why", the notes become much better and down-to-the-earth style which suits us better..

Although using AI has helped us having an efficient way of getting informatoin about our updates out to our clients, it's still many cases where the notes are notes are not clear enough. We also implemented support for adjusting the text, so that our product team can adjust the text when needed.

The Benefits

• Timely Communication: Updates are summarized and shared promptly, keeping users informed without delay.
• Clarity and Consistency: The AI ensures that the tone and style of release notes remain neutral and user-friendly across all updates.
• Efficiency for the Team: Automating this process allows our developers to focus on innovation, knowing that release communication is handled seamlessly.
• Enhanced Transparency: By regularly sharing updates, we foster trust and demonstrate our commitment to improving the Omega 365 experience.

With the rapid advancements in AI, we are confident that its quality will continue to improve. By leveraging structured and well-organized source information, AI engines have a solid foundation for generating highly effective and accurate release notes.