TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Responses to web style guide question From:William Rost <rost -at- GATE -dot- SUNQUEST -dot- COM> Date:Fri, 10 Oct 1997 13:55:55 -0700
I posted the following mail to the techwr-l and winhlp-l. Additionally,
Becca Price cross-posted it to the copyediting-l. (Thanks, Becca!):
----------------------------------------------
Our writing group has been following the "Microsoft Manual of Style for
Technical Publications" for writing Help files and documentation
for Windows-based applications. I'm searching for a similar style
manual or guide that addresses the nuances of documenting
web-based applications.
Anyone know of such a manual? Is anyone out there working on such a
manual?
If you have information, please either e-mail the information to me or
post it. I'll compile all responses and post them to the list.
------------------------------------------------------------------------------------
Here are the results from 11 replies:
Respondents who:
-Know of a style guide for documenting web-based applications: 0
-Suggested guides or web sites for online writing
or web-design styles: 7
-Asked for info about the Microsoft style guide: 2
(Microsoft Manual of Style, ISBN 1-55615-939-0)
-Don't have suggestions, but are also looking: 2
Christine Jesensky <Xine -at- MicroScript -dot- com> sent the following list,
which has plenty of good references.
Thank you all for your suggestions,
Salut/Bill Rost
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html