<html><head><style type='text/css'>p { margin: 0; }</style></head><body><div style='font-family: Times New Roman; font-size: 12pt; color: #000000'>Nice job, David!  This really looks great. Awesome, in fact, for a first cut.<div><br></div><div>One thing that jumped out at me: in the swift.properties section:</div><div><br></div><div>- the actual descriptions should be in plain text, not fixed width text</div><div><br></div><div>- to keep the descriptions in sync with the sample/default swift.properties file in etc/, perhaps the sample file could be coded in such a way that we can grep the properties out in a "doc build" process that runs as part of ant or make, and automatically include them in the users guide.</div><div><br></div><div>- Perhaps move the properties to an appendix rather than a chapter - the chapter could just talk about how to manage properties, and what the general "families" of properties are.</div><div><br></div><div>Mike</div><div><br><br><hr id="zwchr"><blockquote style="border-left:2px solid rgb(16, 16, 255);margin-left:5px;padding-left:5px;">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>
</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>