RE: Riddle Me This

Subject: RE: Riddle Me This
From: "Jane Carnall" <jane -dot- carnall -at- digitalbridges -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 3 Jul 2001 13:28:48 +0100

Bruce Byfield wrote:
> And, if you're a lone writer, there's probably not much point in getting
> too worried about style books anyway - just be consistent in your usage.
> The value of a style book comes in team projects, or with documentation
> that you plan to hand off to someone else.

Peter responded:
>tRUE, [Unless You Have Want to Use Your Work In Your portfolio.] :-)

Nope, even then. The nice thing about standards, as someone on this list
sigs, is there are so many to choose from. Poor grammar, mis-spellings, and
typos would all be bad things to include in your portfolio, but no one would
expect a portfolio of projects completed at other companies to conform to
the style guide at *this* company. If they query issues of style in any
items in your portfolio, providing (as Bruce said above) you were consistent
in your usage, you can honestly say: "That conformed to the documentation
style in use at the company I worked for then."

Jane Carnall
Technical Writer, Digital Bridges, Scotland
Unless stated otherwise, these opinions are mine, and mine alone.


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

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com

TECH*COMM 2001 Conference, July 15-18 in Washington, DC
The Help Technology Conference, August 21-24 in Boston, MA
Details and online registration at http://www.SolutionsEvents.com


---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


References:
Re: Riddle Me This: From: Peter

Previous by Author: Un-Interesting Amerocentrism on the list (was RE: Big Brother)
Next by Author: RE: Portfolio For a New Tech Writer?
Previous by Thread: Re: Riddle Me This
Next by Thread: Re: Riddle Me This


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


Sponsored Ads