<html><head><style type='text/css'>p { margin: 0; }</style></head><body><div style='font-family: Times New Roman; font-size: 12pt; color: #000000'>Yes, indeed.  We also have a long list of changes we want to make in the user guide; some of these are in bugzilla; others are in private notes we need to turn into doc bugs.<div><br></div><div>Ben's initial Users Guide has served us well, but now its time for some major (but incremental) revamping.</div><div><br></div><div>Some of the material from the ParCo paper can go into the Users Guide.</div><div><br></div><div>Also:</div><div>- more thorough explanation of the basic data and execution model</div><div>- more clear explanation of mapping (ParCo has some of that) with more examples and explanations of techniques</div><div>- improved diagrams of the runtime environment</div><div>- more explanation of runtime environment issues like retry and replication (beyond whats in the properties descriptions)</div><div>- lots of clarification needed on Coasters and providers in general</div><div>- section on script development and debugging</div><div>- annotated examples (can start with ParCo examples; need some simpler ones too)</div><div><br></div><div>In general - much work ahead of us here.</div><div><br></div><div>- Mike</div><div><br></div><div><br></div><div><br></div><div><hr id="zwchr"><blockquote style="border-left:2px solid rgb(16, 16, 255);margin-left:5px;padding-left:5px;">We need someone new to go through this...  Perhaps we could ask Lorenzo to do this?<div><br></div><div>Just skimming...</div><div><br></div><div>I think the table is 2.11 should only have one operator in each row<div><br></div><div>I'm unclear about the first table in 3.1.  perhaps there should be some code or text before it?</div><div><br></div><div><br></div><div><br></div><div><br></div><div><br><div><div>On May 4, 2011, at 3:58 PM, David Kelly wrote:</div><br class="Apple-interchange-newline"><blockquote>Hello,<div><br></div><div>I just finished the preliminary version of the user guide in asciidoc. It is at <a href="http://www.ci.uchicago.edu/~davidk/userguide.html" target="_blank">http://www.ci.uchicago.edu/~davidk/userguide.html</a>. The asciidoc source is at <a href="http://www.ci.uchicago.edu/~davidk/userguide.txt" target="_blank">http://www.ci.uchicago.edu/~davidk/userguide.txt</a>.</div>
<div><br></div><div>David</div><div><br></div>
_______________________________________________<br>Swift-devel mailing list<br><a href="mailto:Swift-devel@ci.uchicago.edu" target="_blank">Swift-devel@ci.uchicago.edu</a><br>http://mail.ci.uchicago.edu/mailman/listinfo/swift-devel<br></blockquote></div><br><div>
<span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; font-size: medium; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; font-size: medium; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div><span class="Apple-style-span" style="font-family: Courier; font-size: 12px; ">-- </span></div><div><span class="Apple-style-span" style="font-size: 9px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><span class="Apple-style-span" style="font-family: 'Lucida Grande'; font-size: 10px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><span class="Apple-style-span" style="font-family: Helvetica; font-size: 12px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; font: normal normal normal 12px/normal Helvetica; "><font class="Apple-style-span" face="Courier">Daniel S. Katz</font></div><div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; font: normal normal normal 12px/normal Helvetica; "><font class="Apple-style-span" face="Courier">University of Chicago</font></div><div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; font: normal normal normal 12px/normal Helvetica; "><font class="Apple-style-span" face="Courier">(773) 834-7186 (voice)</font></div><div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; font: normal normal normal 12px/normal Helvetica; "><font class="Apple-style-span" face="Courier">(773) 834-6818 (fax)</font></div><div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; font: normal normal normal 12px/normal Helvetica; "><font class="Apple-style-span" face="Courier"><a href="mailto:d.katz@ieee.org" target="_blank">d.katz@ieee.org</a> or <a href="mailto:dsk@ci.uchicago.edu" target="_blank">dsk@ci.uchicago.edu</a></font></div><div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; font: normal normal normal 12px/normal Helvetica; min-height: 14px; "><span class="Apple-style-span" style="font-family: Courier; "><a href="http://www.ci.uchicago.edu/~dsk/" target="_blank">http://www.ci.uchicago.edu/~dsk/</a></span></div><div><span class="Apple-style-span" style="font-size: medium; "><font class="Apple-style-span" face="Courier" size="3"><span class="Apple-style-span" style="font-size: 12px; "><br></span></font></span></div></div></div></span></div></div></div></span></div></div></span></div></div></div></span><br class="Apple-interchange-newline"></span><br class="Apple-interchange-newline">
</div>
<br></div></div><br>_______________________________________________<br>Swift-devel mailing list<br>Swift-devel@ci.uchicago.edu<br>http://mail.ci.uchicago.edu/mailman/listinfo/swift-devel<br></blockquote><br><span><br><br>-- <br><span name="x"></span>Michael Wilde<br>Computation Institute, University of Chicago<br>Mathematics and Computer Science Division<br>Argonne National Laboratory<br><span name="x"></span><br></span></div></div></body></html>