<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:st1="urn:schemas-microsoft-com:office:smarttags" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=us-ascii">
<meta name=Generator content="Microsoft Word 11 (filtered medium)">
<!--[if !mso]>
<style>
v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style>
<![endif]--><o:SmartTagType
namespaceuri="urn:schemas-microsoft-com:office:smarttags" name="Street"/>
<o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
name="address"/>
<!--[if !mso]>
<style>
st1\:*{behavior:url(#default#ieooui) }
</style>
<![endif]-->
<style>
<!--
/* Font Definitions */
@font-face
{font-family:"MS Mincho";
panose-1:2 2 6 9 4 2 5 8 3 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
@font-face
{font-family:"Comic Sans MS";
panose-1:3 15 7 2 3 3 2 2 2 4;}
@font-face
{font-family:"\@MS Mincho";
panose-1:2 2 6 9 4 2 5 8 3 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman";}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{color:purple;
text-decoration:underline;}
p
{mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
font-size:12.0pt;
font-family:"Times New Roman";}
span.EmailStyle18
{mso-style-type:personal;
font-family:Arial;
color:navy;}
span.EmailStyle20
{mso-style-type:personal-reply;
font-family:"Comic Sans MS";
color:maroon;
font-weight:normal;
font-style:normal;
text-decoration:none none;}
@page Section1
{size:8.5in 11.0in;
margin:1.0in 1.25in 1.0in 1.25in;}
div.Section1
{page:Section1;}
-->
</style>
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang=EN-US link=blue vlink=purple>
<div class=Section1>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'>This may be a
small part of a larger issue. <o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'><o:p> </o:p></span></font></p>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'>As the Open
Fabrics products gain a larger customer base, we cannot assume that all users will
be actively following the mailing lists. A detailed Users Guide which
covers issues such as installation as well as the features and use of each ULP is
necessary forthose who are not intimately familiar with the OFED/WinOF
offerings. <o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'><o:p> </o:p></span></font></p>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'>In addition,
there is currently no documentation that informs anyone of changes between
releases of OFED/WinOF. Even those who are working to test release candidates
do not have enough information as to what has changed between builds. <o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'><o:p> </o:p></span></font></p>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'>In order to
build a legitimate set of user documentation, there needs to be a more formal
process for developers to document changes, enhancements and bug fixes that are
added to a release. This does not have to be a major burden on the
developers; a few comments in a pre-determined README file would go a long way to
improving communication of changes to the product. This would ensure that the
community adequately tests updates to the products and that end-users would
have the information they need to get the most out of it.<o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'><o:p> </o:p></span></font></p>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'>Just my
2-cents.<o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=maroon face="Comic Sans MS"><span
style='font-size:10.0pt;font-family:"Comic Sans MS";color:maroon'><o:p> </o:p></span></font></p>
<div>
<div class=MsoNormal align=center style='text-align:center'><font size=3
face="Times New Roman"><span style='font-size:12.0pt'>
<hr size=3 width="100%" align=center tabindex=-1>
</span></font></div>
<p class=MsoNormal><b><font size=2 face=Tahoma><span style='font-size:10.0pt;
font-family:Tahoma;font-weight:bold'>From:</span></font></b><font size=2
face=Tahoma><span style='font-size:10.0pt;font-family:Tahoma'>
ewg-bounces@lists.openfabrics.org [mailto:ewg-bounces@lists.openfabrics.org] <b><span
style='font-weight:bold'>On Behalf Of </span></b>Ryan, Jim<br>
<b><span style='font-weight:bold'>Sent:</span></b> Saturday, November 22, 2008
5:41 PM<br>
<b><span style='font-weight:bold'>To:</span></b> Hebenstreit, Michael;
ewg@lists.openfabrics.org; mwg@lists.openfabrics.org;
bboas@systemfabricworks.com<br>
<b><span style='font-weight:bold'>Subject:</span></b> [ewg] RE: Panel at
SC08/Austin -- what can we do about this?</span></font><o:p></o:p></p>
</div>
<p class=MsoNormal><font size=3 face="Times New Roman"><span style='font-size:
12.0pt'><o:p> </o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'>I’m not completely clear about the
genesis of the email below and the points that were made, but I thought this
was extremely interesting. Maybe I’m unreasonably impressed because I got
similar questions from people stopping by the OpenFabrics booth at SC’08.
Just, as one example, a professor at The University of Tokyo asked for a
“programming manual”, which I understood to mean a
how-to-get-started document for implementing high-performance networks<o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'><o:p> </o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'>I’m copying the Marketing Working
Group of OFA and will do so further to see if there’s someone who can act
on these concerns. I think ignorance of basics is a major challenge for OFA to
address for broader acceptance of the interconnects we support<o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'><o:p> </o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'>Thanks, Jim Ryan<o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'><o:p> </o:p></span></font></p>
<div>
<div class=MsoNormal align=center style='text-align:center'><font size=3
face="Times New Roman"><span style='font-size:12.0pt'>
<hr size=2 width="100%" align=center tabindex=-1>
</span></font></div>
<p class=MsoNormal><b><font size=2 face=Tahoma><span style='font-size:10.0pt;
font-family:Tahoma;font-weight:bold'>From:</span></font></b><font size=2
face=Tahoma><span style='font-size:10.0pt;font-family:Tahoma'>
ewg-bounces@lists.openfabrics.org [mailto:ewg-bounces@lists.openfabrics.org] <b><span
style='font-weight:bold'>On Behalf Of </span></b>Hebenstreit, Michael<br>
<b><span style='font-weight:bold'>Sent:</span></b> Friday, November 21, 2008
3:10 PM<br>
<b><span style='font-weight:bold'>To:</span></b> ewg@lists.openfabrics.org<br>
<b><span style='font-weight:bold'>Subject:</span></b> [ewg] Panel at
SC08/Austin</span></font><o:p></o:p></p>
</div>
<p class=MsoNormal><font size=3 face="Times New Roman"><span style='font-size:
12.0pt'><o:p> </o:p></span></font></p>
<div>
<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>At the session I raised points about missing documentation
and was askled to summarize my ideas and write it to this list. specifically I
would like to see</span></font><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><font size=3 face="Times New Roman"><span style='font-size:
12.0pt'> <o:p></o:p></span></font></p>
</div>
<div>
<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>a) a PDF binder of all mans/docs already available in the distribution
on the web site</span></font><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>b) a howto start with OFED (example: a collegue of mine had
no idea that he needs a running opensm ...)</span></font><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>c) for each special feature like "ipoib, sdp,
opensm..." one or two pages describing WHAT the technology want's to
achieve, plus some examples how it is used; how to enable/configure it</span></font><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>d) on technologies like VERB/DAPL/...: one or two pages
describing WHAT the technology want's to achieve, plus some examples how it is
used; a few simple examples how to program with the libraries (at the level of
a MPI introduction)</span></font><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><font size=3 face="Times New Roman"><span style='font-size:
12.0pt'> <o:p></o:p></span></font></p>
</div>
<div>
<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>best regards</span></font><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><font size=2 face=Arial><span style='font-size:10.0pt;
font-family:Arial'>Michael</span></font><o:p></o:p></p>
</div>
<div>
<p class=MsoNormal><font size=3 face="Times New Roman"><span style='font-size:
12.0pt'> <o:p></o:p></span></font></p>
</div>
<div>
<p style='margin-bottom:12.0pt'><font size=2 face="Courier New"><span
style='font-size:10.0pt;font-family:"Courier New"'>------------------------------------------------------------------------<br>
Michael <span class=spelle>Hebenstreit</span>
Senior Cluster Architect<br>
Intel
Corporation
Software and Services Group/DRD<br>
<st1:Street w:st="on"><st1:address w:st="on">2800 N Center Dr</st1:address></st1:Street>,
DP3-307
Tel.: +1 253 371 3144<br>
WA 98327,
DuPont <br>
UNITED STATES
E-mail: michael.hebenstreit@intel.com<br>
<br>
<o:p></o:p></span></font></p>
</div>
<div>
<p class=MsoNormal><font size=3 face="Times New Roman"><span style='font-size:
12.0pt'> <o:p></o:p></span></font></p>
</div>
</div>
</body>
</html>