Re: Refining My "Cutting Edge" Technical Writing Skills Post

Subject: Re: Refining My "Cutting Edge" Technical Writing Skills Post
From: "Bonnie Granat" <bgranat -at- editors-writers -dot- info>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 17 Sep 2003 11:32:22 -0400



----- Original Message -----
From: "John Posada" <JPosada -at- book -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Sent: September 17, 2003 11:20 AM
Subject: RE: Refining My "Cutting Edge" Technical Writing Skills Post


>
> >No, not quite. <g> The more complex the subject, the
> >more time should be spent to make sure the
> >documentation makes sense.
>
> I don't know...
>
> If I have a real complex subject, I'll spend a great deal of time learning
> about it...it's now not complex to me.

Complexity is a permanent property, and it does not disappear because you
understand the subject.

Which means, I should be able to
> pound out the document pretty fast,

If the subject is complex, your documentation should be created with great
care.


which makes it proportionally smaller
> against the learning time than a subject that is relatively simple, but I
> know very little about it, which means I've spent more tome on the document
> against the time I spent on the learning.
>

Sorry, but I 'm not following you, John.



> Let's say I take 3 weeks to learn something complex, and a week to write
> about it. The writing is 33% of the learning. On the toaster, I spend a day
> writing, but only a day learning. The writing is now 100% of the learning.
>

In this scenario, I tend to agree with you.

___________________________
Bonnie Granat
Granat Editorial Services
http://www.editors-writers.info
Fast | Accurate | Affordable



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

NEED TO PUBLISH YOUR FRAMEMAKER CONTENT ONLINE?
?Mustang? (code name) is a NEW online publishing tool for FrameMaker that
lets you easily single-source content to Web, intranets, and online Help.
The interface is designed for FrameMaker users, so there is little or no
learning curve and no macro language required! See a live demo that
will take your breath away: http://www.ehelp.com/techwr-l3

---
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: Refining My "Cutting Edge" Technical Writing Skills Post: From: John Posada

Previous by Author: Re: Refining My "Cutting Edge" Technical Writing Skills Post
Next by Author: Re: Refining My "Cutting Edge" Technical Writing Skills Post
Previous by Thread: RE: Refining My "Cutting Edge" Technical Writing Skills Post
Next by Thread: Re: Refining My "Cutting Edge" Technical Writing Skills Post


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


Sponsored Ads