Release Notes: 7 Steps to Better Enhancements

Want to improve the quality of the enhancements in your Release Notes? Here are seven ways. Enhancement Identifier Provide the reference number for the enhancement, such as Salesforce 12345. Business value Describe the benefit to the user if they use this enhancement. Usually, there is a specific business driver or customer request behind each enhancement’s […]

Release Notes: Sample Text for Writing Enhancements

An enhancement is a new feature, or an improvement to a current feature, included in the current release. To help the reader understand the enhancement, describe: Where the enhancement is located in the user interface. What parameters need to be configured. What is the default setting. Why you should use this enhancement, for example, a […]

Lessons Learned from Collaborative Writing Projects

We make mistakes every week on our Technical Writing projects. However, since we’ve started to capture things in our lessons learned meetings, the ‘repeat offenders’ have gone down. Running web-based Technical Writing projects is difficult as you don’t get to meet the team you’re managing, so sessions like this can make a real difference.