Documentation Best Practices

[Galanter, Lea]

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.