<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML><HEAD>
<META http-equiv=Content-Type content="text/html; charset=us-ascii">
<META content="MSHTML 6.00.6000.17097" name=GENERATOR></HEAD>
<BODY>
<DIV dir=ltr align=left><FONT face=Arial color=#0000ff><SPAN
class=850261422-05122011>If they insist, I would make sure that it is
well-marked as a future enhancement, perhaps is a separate section of the
documentation.</SPAN></FONT></DIV>
<DIV dir=ltr align=left><FONT face=Arial color=#0000ff><SPAN
class=850261422-05122011></SPAN></FONT> </DIV>
<DIV dir=ltr align=left><FONT face=Arial color=#0000ff><SPAN
class=850261422-05122011>I just had a situation where a major aircraft maker
(the one that does not start with a "B") gave all sorts of very specific
information about a software tool to make suppliers lives easier in a reference
guide and on their website. When I went to track down the tool I discovered that
it does not actually exist yet. Very frustrating.</SPAN></FONT></DIV>
<DIV dir=ltr align=left><FONT face=Arial color=#0000ff><SPAN
class=850261422-05122011></SPAN></FONT> </DIV>
<DIV dir=ltr align=left><FONT face=Arial color=#0000ff><SPAN
class=850261422-05122011>Clint</SPAN></FONT></DIV>
<DIV> </DIV><?xml:namespace prefix = o ns =
"urn:schemas-microsoft-com:office:office" /><o:SmartTagType
namespaceuri="urn:schemas-microsoft-com:office:smarttags"
name="country-region"></o:SmartTagType><o:SmartTagType
namespaceuri="urn:schemas-microsoft-com:office:smarttags"
name="place"></o:SmartTagType>
<STYLE>st1\:* {
BEHAVIOR: url(#ieooui)
}
</STYLE>
<STYLE>@font-face {
font-family: Arial Narrow;
}
@page Section1 {size: 8.5in 11.0in; margin: 1.0in 1.25in 1.0in 1.25in; mso-header-margin: .5in; mso-footer-margin: .5in; mso-paper-source: 0; }
P.MsoNormal {
FONT-SIZE: 12pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"; mso-style-parent: ""; mso-pagination: widow-orphan; mso-fareast-font-family: "Times New Roman"
}
LI.MsoNormal {
FONT-SIZE: 12pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"; mso-style-parent: ""; mso-pagination: widow-orphan; mso-fareast-font-family: "Times New Roman"
}
DIV.MsoNormal {
FONT-SIZE: 12pt; MARGIN: 0in 0in 0pt; FONT-FAMILY: "Times New Roman"; mso-style-parent: ""; mso-pagination: widow-orphan; mso-fareast-font-family: "Times New Roman"
}
DIV.Section1 {
page: Section1
}
</STYLE>
<DIV class=Section1>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 10pt; COLOR: gray; FONT-FAMILY: 'Arial Narrow'"><o:p> </o:p></SPAN></P>
<P class=MsoNormal><SPAN
style="FONT-SIZE: 11pt; FONT-FAMILY: Arial">Clint Owen | Sr.
Technical Writer | Crane Aerospace & Electronics
| +1 425 743 8674 | Fax:
+1 425 743 8113<o:p></o:p></SPAN></P></DIV>
<DIV> </DIV><BR>
<DIV class=OutlookMessageHeader lang=en-us dir=ltr align=left>
<HR tabIndex=-1>
<FONT face=Tahoma size=2><B>From:</B> framers-bounces@lists.frameusers.com
[mailto:framers-bounces@lists.frameusers.com] <B>On Behalf Of
</B>hessiansx4<BR><B>Sent:</B> Monday, December 05, 2011 2:56 AM<BR><B>To:</B>
framers@lists.frameusers.com<BR><B>Subject:</B> documentation best
practices<BR></FONT><BR></DIV>
<DIV></DIV>
<DIV
style="FONT-SIZE: 10pt; COLOR: #000; FONT-FAMILY: verdana, helvetica, sans-serif; BACKGROUND-COLOR: #fff">
<DIV style="RIGHT: auto">I could use some insight into a situation I haven't
encountered before today: how does one best respond to a request (read: order)
to include something in their product's documentation about a functionality that
will not be released with the upcoming release (it will still be in
development) but is hoped to be ready "shortly" (whatever that
means) after the product is released.</DIV>
<DIV style="RIGHT: auto"> </DIV>
<DIV style="RIGHT: auto">I've politely pointed out that industry best practice
is to document what IS as opposed to what WILL BE and that certain liabilities
might be incurred if promises are made and then something goes wrong. </DIV>
<DIV style="RIGHT: auto"> </DIV>
<DIV style="RIGHT: auto">Any thoughts?<VAR
id=yui-ie-cursor></VAR></DIV></DIV>
<HR>
<P><FONT face=Tahoma color=#000000 size=1>Check out the new Crane Aerospace
Electronics <A href="http://newsroom.craneae.com/">Newsroom</A>!<BR>Like us on
<A
href="http://www.facebook.com/home.php?#!/pages/Crane-Aerospace-Electronics/163305413682908">Facebook</A>!<BR></FONT><A
href="http://www.craneae.com/surveys/satisfaction.htm"><FONT face=Tahoma
color=#000000 size=1>We value your opinion<SPAN style="TEXT-DECORATION: none">!
</SPAN></FONT></A><FONT face=Tahoma size=1> How may we serve you better?
Please click the survey link to tell us how we are doing: </FONT><A
href="http://www.craneae.com/surveys/satisfaction.htm"><FONT face=Tahoma
size=1>http://www.craneae.com/surveys/satisfaction.htm</FONT></A> </P>
<P></P>
<P><FONT face=Tahoma size=1>Your feedback is of the utmost importance to us.
Thank you for your time.</FONT></P>
<P><FONT face=Tahoma size=1>Crane Aerospace & Electronics Confidentiality
Statement:<BR><FONT color=#808080>The information contained in this email
message may be privileged and is confidential information intended only for the
use of the recipient, or any employee or agent responsible to deliver it to the
intended recipient. Any unauthorized use, distribution or copying of this
information is strictly prohibited and may be unlawful. If you have received
this communication in error, please notify the sender immediately and destroy
the original message and all attachments from your electronic files.<BR>
<HR>
</FONT></FONT>
</BODY></HTML>