Principles, practices, and patterns approach to writing style guides? (was: Writing guides)

Subject: Principles, practices, and patterns approach to writing style guides? (was: Writing guides)
From: Kelley Walker <kelley -dot- walker -at- libtax -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 17 Aug 2012 17:41:53 -0400

Hi there -

Speaking of writing guides, I'm a UX Architect tasked with developing style guidelines that developers will actually use and to do so for all aspects of the user experience - from the user interface guidelines for software engineers to a manual of writing style for content developers.

I laughed when I took this position. User experience practitioners write UI style guides and the like all the time, but I've seldom seen much published about how to make documentation usable. Of course, I'm hoping that technical writers will know about resources with which I'm not familiar.

At any rate, I've decided to draw on MMOS, 4th ed., and then supplement with our company style guidelines by employing the principles, practices, and patterns approach that is common to software engineering.

Does anyone know if anyone has done this for a writing style guide? If so, is there a published, publicly accessible example?

On an old home days note, I used to belong to the list years ago. What ever happened to Andrew Plato? :)


Kelley Walker
UX Architect


This electronic communication and any files transmitted with it, or attached to it, are confidential and are intended solely for the use of the individual or entity to whom it is addressed and may contain information that is confidential, legally privileged, protected by privacy laws, or otherwise restricted from disclosure to anyone else. If you are not the intended recipient or the person responsible for delivering the e-mail to the intended recipient, be advised that you have received this e-mail in error, and that any use, dissemination, forwarding, printing, or copying of this e-mail is strictly prohibited. If you received this e-mail in error, please return the e-mail to the sender, delete it from your computer and destroy any printed copy of it. Although our company attempts to sweep e-mail and attachments for viruses, it does not guarantee that either are virus-free and accepts no liability for any damage sustained as a result of viruses.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.

Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.

http://bit.ly/doc-to-help

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

Previous by Author: RH9 problems with imported HTML files
Next by Author: RE: Principles, practices, and patterns approach to writing style guides? (was: Writing guides)
Previous by Thread: Re: Writing guides
Next by Thread: Re: Principles, practices, and patterns approach to writing style guides? (was: Writing guides)


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads