Re: What's THAT for?

[Marguerite Krupp <mkrupp128 -at- yahoo -dot- com>]

And you know that if you leave it undocumented, SOMEBODY out there will try to use it, then file a bug stating the the port (or whatever) is nonfunctional. 
 
I like the "Do not use" appendage, too. "Belt and suspenders," so to speak.
 
Marguerite

--- On Thu, 8/5/10, Monique Semp <monique -dot- semp -at- earthlink -dot- net> wrote:


From: Monique Semp <monique -dot- semp -at- earthlink -dot- net>
Subject: Re: What's THAT for?
To: "Sally Derrick" <sjd1201 -at- gmail -dot- com>, "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
Cc: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thursday, August 5, 2010, 10:57 AM


I agree (vehemently :-) with Sally -- do not leave things undocumented!

A less wordy phrase I often use is "For future use."  Makes it look
intentional, planned, and conveys that nothing will happen if you use it at
now.

-Monique

>
> It's not cool to leave those things undocumented...
> Sally
>
> > how do you refer to unused physical features like (say)


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

Gain access to everything you need to create and publish information 
through multiple channels. Your choice of authoring (and import)
formats with virtually any output. Try Doc-To-Help free for 30-days. 
http://www.doctohelp.com/

LavaCon 2010 in San Diego Sept 29 - Oct 2 is now open for registration.  
   Use referral code TECHWR-L for $50 off conference tuition! 
          See program at: http://lavacon.org/


---
You are currently subscribed to TECHWR-L as mkrupp128 -at- yahoo -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/mkrupp128%40yahoo.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

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

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat




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

Gain access to everything you need to create and publish information 
through multiple channels. Your choice of authoring (and import)
formats with virtually any output. Try Doc-To-Help free for 30-days. 
http://www.doctohelp.com/

LavaCon 2010 in San Diego Sept 29 - Oct 2 is now open for registration.  
   Use referral code TECHWR-L for $50 off conference tuition! 
          See program at: http://lavacon.org/


---
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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

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

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat