I think a few examples can go a long way. <br><br>I remembered seeing a lot of requests for examples in the results, so I went back and skimmed the spreadsheet. I found that 11 of the 34 responses under Library Documentation explicitly called out examples as desirable.<br>
<br>Combined with Heinrich's experience, this sounds pretty promising to me. <br><br>Cheers,<br>Nick<br><br><div class="gmail_quote">On 15 September 2011 05:24, Heinrich Apfelmus <span dir="ltr"><<a href="mailto:apfelmus@quantentunnel.de">apfelmus@quantentunnel.de</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;"><div class="im">Malcolm Wallace wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
In fact, my wish as a library author would be: please tell me what<br>
you, as a beginner to this library, would like to do with it when you<br>
first pick it up? Then perhaps I could write a tutorial that answers<br>
the questions people actually ask, and tells them how to get the<br>
stuff done that they want to do. I have tried writing documentation,<br>
but it seems that people do not know how to find, or use it.<br>
Navigating an API you do not know is hard. I'd like to signpost it<br>
better.<br>
</blockquote>
<br></div>