Documentation Best Practices

[Writer]

Nicely put.

Nadine




>________________________________
> From: "Galanter, Lea" <Lea.Galanter at fticonsulting.com>
>To: framers at lists.frameusers.com 
>Sent: Tuesday, December 6, 2011 1:30:28 PM
>Subject: RE: Documentation Best Practices
> 
>Don't know if anyone has mentioned this, but the reason why you're not
>supposed to mention what will be in future versions is for legal
>reasons. You should not make forward-looking statements because the
>company could be held legally responsible for them. And since none of us
>can guarantee what the future holds, it behooves the company to state
>only what it can legally prove about its product. That being said, if
>you wanted to make assertions about future features, you could include a
>forward-looking disclaimer. See the Wikipedia article on this at
>http://en.wikipedia.org/wiki/Forward-looking_statement.
>
>Perhaps pointing this out to your managers would allow them to rethink
>this one.
>
>Lea Galanter
>Technical Editor
>Seattle, WA
>
>
>Confidentiality Notice:
>
>This email and any attachments are confidential and meant solely for the use of the intended recipient. If you are not the intended recipient any disclosure, copying, distribution or use of the e-mail or any attachment is prohibited. If you have received this email in error, please notify us immediately by replying to the sender and then delete this copy and the reply from your system. Thank you for your cooperation.
>
>_______________________________________________
>
>
>You are currently subscribed to framers as generic668 at yahoo.ca.
>
>Send list messages to framers at lists.frameusers.com.
>
>To unsubscribe send a blank email to
>framers-unsubscribe at lists.frameusers.com
>or visit http://lists.frameusers.com/mailman/options/framers/generic668%40yahoo.ca
>
>Send administrative questions to listadmin at frameusers.com. Visit
>http://www.frameusers.com/ for more resources and info.
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.frameusers.com/pipermail/framers-frameusers.com/attachments/20111206/6077e0c8/attachment.htm>