Hello, everybody:

I'm working on a project to publish some of my department's documentation to our enterprise WCMS. Our standards committee is struggling with creating basic design criteria such as formatting. For example, when should bold be used, etc. Reasonably, the committee has wondered if we're re-inventing the wheel.

Our audience is primarily end users (UNM faculty and students and some staff) mainly for web-based applications, but stand-alone apps come into it as well.

I was wondering if any of you know of style guides that address writing technical documentation, especially documentation that will appear on the web.

I've sent a similar messages out to specific folks and some lists, so I apologize for the repetition if you see this more than once.


Views: 81

Replies to This Discussion

Hey Greg,

If you belong to LinkedIn, here's a local group you can tap:  http://www.linkedin.com/groups?about=&gid=2214390&trk=anet_...


And here's the Web site:  http://www.stc-nm-kachina.org/






Hi, Leon:


I'll look into this. Thanks for taking the time to reply!



I've generally found that using the Wikipedia Style Guide covers a lot of possibilities:



Good stuff.

Hi, Steve:


Thanks for the lead!



Hi, Rob:


Yeah, a good resource.




Re:  Technical documentation style guide.  Google knows all, tells all -- http://www.writtendesigns.com/documents/TechnicalStyleGuide.pdf

Re:  Writing for the Web.  Memorize everything Jakob Nielsen has ever written. 


Wow.  Tops it all.

Hi, Karl:







Connect with Us!

Albuquerque's Community Forum

Microsoft Team Foundation Server 2013 ... Yay or Nay?

Started by AriesSweet Sep 30, 2014.

JIRA users anywhere? 2 Replies

Started by AriesSweet. Last reply by AriesSweet Nov 21, 2013.

Startup Weekend Albuquerque

Started by Eric Renz-Whitmore Jun 19, 2013.

Web Programmer Open

Started by Shannon Jun 11, 2013.

Latest Activity

vinceinburque posted a discussion
7 hours ago
IMEC Jewelry + Gallery posted a blog post
10 hours ago
Profile IconDuke City Fix via Facebook

Daily Photos by Dee Cohen

NM Pics: Fast Stop


Truth or Consequences

Facebook21 hours ago · Reply
Adelita liked Dee Cohen's blog post NM Pics: Fast Stop
21 hours ago

Regular Features

Anyone can blog on the Duke City Fix, but here are the folks who blog most often:

© 2015   Created by Duke City Fix.   Powered by

Badges  |  Report an Issue  |  Terms of Service