Home Library Translate
A A A
Share »
Follow us on Facebook Follow us on Twitter Follow us on LinkedIn
Connect »

Blog: Business Communications

Menu

  • This Blog's Home
  • Guest Writer Submissions
  • Policies
  • To Subscribe to a Blog
  • About
  • Feedback

Tips For Creating Release Notes

By Theresa Pojuner on April 20, 2015

Release Notes are often written to communicate software or product updates. They define what is new. Release Notes allow us to manage, announce, and activate any new hardware, software, application, product models or devices.

Release Notes include:

  • A history – state why this document was created.
  • Version # – state the version or control number and what original project it was a part of and other documents involved.
  • What requirements are needed – state application software, hardware, data, etc.
  • What is new – state all the new features. List a comparison to the old to make it clearer.
  • What was modified – state the reason behind the modification and state the new changes that were made. The product could have been too complicated to operate so steps were taken to make its function simpler.
  • What was removed – state what originally existed and why it was removed. It could be because the usage was no longer valid or out-or-date or something new was created to take its place.
  • What was added – state any new features or what was added to make the product better and more useful.
  • What was fixed – state what problems or errors were corrected and/or modified. List detailed information if required and what was needed and done to correct the problems.
  • What problems were not fixed – state if any existing problems were not corrected and the reasons why they were not taken care of. State a possible date for corrections to take place in the future.
  • New installations instructions – state how to install the new product or version of an application, model, device, etc. List instructions step-by-step to ensure accuracy and the reason behind each step if necessary.
  • Supporting features – state all other supplementary or beneficial features of the new version, from, for example, adding a new customer hot-line to easier functionality.
  • What has changed – state how the new version has been updated. List all changes, its benefits, and the reason behind it.
  • What has not changed – state any product features that were not updated and the reasons behind it. Reasons could be lack of time, information, resources, etc.
  • What to do – state what has to be done for the new version to take effect or to function.
  • What not to do – state what should not be done. This item should be red flagged to indicate damaging, unsafe, hazardous, etc. elements.
  • What should be displayed – apply Images (of new items or functions), figures (of new items), charts (of new items and benefits), grids for comparison and bulleted items. Bulleted items help to state details within explanations for easier viewing.

Release Notes are needed to provide information on what items were changed and how to operate and use the new or modified versions of a product. They help to maintain organization and to manage operations within any industry.

If you have created release notes and have more to add, please leave a comment. Thank you.

 

 

 

« Previous Next »

Search Our Site

Meet This Blog’s Host

Gail Zack Anderson, President of Applause, Inc., has nearly 20 years experience in training and coaching. She provides individual presentation coaching, and leads effective presentation workshops and effective trainer workshops. [Read more ...]


Theresa Pojuner is a Documentation Specialist with over 20 years of writing experience and is skilled in many areas of documentation, for example, Style Guides, Training Manuals and Test Cases, wth a specialty n Technical Writing and Procedures. [Read more ...]

Recent Blog Posts
Alternate Recent Posts Widget

  • Becoming A Technical Writer-Communicator Review
  • Creating A Knowledge Community
  • Tips for Handling Technical Writer Stress
  • Likeminded Communication
  • A Technical Writer Is Different From Other Writers
  • Involve and Engage Your Audience 20 Ways
  • Tips On Documenting Processes
  • Communicating Technical Writing Review
  • Communicating Via Visual Designs
  • Special Tips for Laptop Presentations

Related Library Topics

  • Body Language
  • Netiquette

Categories of Posts

  • Basics and Overviews
  • Body Language
  • Communicating Change
  • Communication Best Practices
  • Feedback (Sharing)
  • Humor in speaking
  • images
  • Listening
  • Netiquette
  • Presenting
  • slide shows
  • Speaking Skills
  • Team Presentations
  • technical writing
  • Telephone Skills
  • Uncategorized
  • Visual Aids
  • Voice and Vocal Habits
  • Writing

Library's Blogs

  • Boards of Directors
  • Building a Business
  • Business Communications
  • Business Ethics, Culture and Performance
  • Business Planning
  • Career Management
  • Coaching and Action Learning
  • Consulting and Organizational Development
  • Crisis Management
  • Customer Service
  • Facilitation
  • Free Management Library Blogs
  • Fundraising for Nonprofits
  • Human Resources
  • Leadership
  • Marketing and Social Media
  • Nonprofit Capacity Building
  • Project Management
  • Quality Management
  • Social Enterprise
  • Spirituality
  • Strategic Planning
  • Supervision
  • Team Building and Performance
  • Training and Development
About Feedback Legal Privacy Policy Contact Us
Free Management Library, © Copyright Authenticity Consulting, LLC ®; All rights reserved.
  • Graphics by Wylde Hare LLC
  • Website maintained by Caitlin Cahill

By continuing to use this site, you agree to our Privacy Policy.X