: Re: Should software product release notes be in marketing voice or technical voice? (software documentation) Typically, the voice of marketing content doesn't match the voice of technical content --

In my opinion Release Notes should be written in a technical style, focused on the technical implications of the most recent changes. This makes them sort of a mix between the two worlds - you want to target decision makers and technical people and tell them what has changed when compared to the older version of the software, emphasizing what the problems are that may arise from these changes or what the problems are that these changes fix.

You don't want to sell the newest features and the whole product to the decision makers - they have already bought the product and want to know whether changing to the new version will cost them too much or if the fixes will offset the update costs.

You also don't want to sell the product to the technical people - they want to know what of their daily work will change by using the new version.

But you want to make it easy and fast to understand for everyone familiar with the old version of the software.

Load Full (0)

: Is it better to repeat steps listed elsewhere in a manual, or to refer the reader to where the steps are listed elsewhere in the manual? We have a tool that we cannot replace that does not

@Ann1701686

Load Full 2 Comments

: Where can I find resources about writing "Choose your own adventure"-style books? I have read/played a couple of "Choose your own adventure"-style book and am interested in the process of creating

@Ann1701686

Load Full 4 Comments

: Not quite a tone of voice, but I remember two book series where telepathy was distinguished from normal speech by a special syntax. In one of them phrases spoken telepathically were in cursive

@Ann1701686

Load Full 0 Comments

: I keep most of it in my head; but when I do write it down I just use an outline in a standard text editor. Word or Google docs is fine. The lowest level is the chapter, then the next

: Re: Should software product release notes be in marketing voice or technical voice? (software documentation) Typically, the voice of marketing content doesn't match the voice of technical content --

More posts by @Ann1701686

: Is it better to repeat steps listed elsewhere in a manual, or to refer the reader to where the steps are listed elsewhere in the manual? We have a tool that we cannot replace that does not

: Where can I find resources about writing "Choose your own adventure"-style books? I have read/played a couple of "Choose your own adventure"-style book and am interested in the process of creating

: Not quite a tone of voice, but I remember two book series where telepathy was distinguished from normal speech by a special syntax. In one of them phrases spoken telepathically were in cursive

: I keep most of it in my head; but when I do write it down I just use an outline in a standard text editor. Word or Google docs is fine. The lowest level is the chapter, then the next

Login to post a comment!

0 Comments

Back to top