<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Fri, May 2, 2014 at 5:06 PM, Greg Hendershott <span dir="ltr"><<a href="mailto:greghendershott@gmail.com" target="_blank">greghendershott@gmail.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
For smaller/simpler libraries I find futzing with gh-pages enough of a<br>
PITA that instead I just do:<br>
<br>
    scribble --markdown manual.scrbl<br>
<br>
The resulting <a href="http://manual.md" target="_blank">manual.md</a> file is directly viewable on GitHub on a<br>
normal branch like master. Example:<br>
<a href="https://github.com/greghendershott/http/blob/master/http/manual.md" target="_blank">https://github.com/greghendershott/http/blob/master/http/manual.md</a><br>
<br></blockquote><div><br></div><div>I completely second this approach. Very simple for a front README.md, but with most of the power of scribble.<br></div><div>One thing that could need improvement IMHO is the verbatim output of several lines, which would be better with a block than with successive single lines of verbatim, as can be seen in the License section at the bottom of the above link. (I had look a little into this issue, but gave up early.)<br>

<br></div><div>Laurent<br></div></div><br></div></div>