When you’re writing within Redgate products, or for release notes or support documentation, consistency is key. It means when a user moves from SQL Prompt to SQL Source Control, for example, everything will be familiar.
The language will be just as clear and succinct. The way commands are used, spelled, and capitalized will be the same. Finding, reading, and understanding release notes and software documentation will be easy.
Achieving that level of uniformity isn’t about having a set of rigid guidelines that tie you down. It’s about setting the parameters within which you write so that boring questions disappear, like whether or not to capitalize buttons, how to structure release notes, or how to use links within text.
Leaving you to think about the interesting stuff: the writing.
For technical writing at Redgate, we generally follow the gov.uk style guide, which says: Write conversationally – picture your audience and write as if you were talking to them one-to-one but with the authority of someone who can actively help. The content you write should be: