<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Jun 2, 2014 at 12:06 AM, Evgeny M <span dir="ltr"><<a href="mailto:donpedrothird@gmail.com" target="_blank">donpedrothird@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">My 2 cents as a more or less erlang noob on the documentation.<div>Most of the docs on the standard modules is fine if you know basics about folds, maps, common data structures etc.</div>
<div>Some of docs, like docs on dets/ets/mnesia selects and matches are vague and need more examples. I for one still not sure why foldl on a table, as Joe Armstrong suggested, is better than match or select. There are other commonly used modules and apps which would benefit from more examples too, <span>the first things that</span> <span>come to my mind are inets and crypto infrastructure with public_key.</span></div>
<div><span><br></span></div><div><span>The docs are not horrible, far from it, but having more examples would be really helpful.</span></div></div></blockquote><div><br></div><div>I agree - two thoughts occur to me. </div>
<div><br></div><div>Firstly, some kind of "reduced" manual pages might be helpful.</div><div>Many modules export a heck of a lot of functions, of which possible half a dozen are the most used and</div><div>most useful. It might be nice to document the "best of" some module. Secondly the "best of" section should have a lot</div>
<div>of simple examples.</div><div><br></div><div>/Joe </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>_______________________________________________<br>
erlang-questions mailing list<br>
<a href="mailto:erlang-questions@erlang.org">erlang-questions@erlang.org</a><br>
<a href="http://erlang.org/mailman/listinfo/erlang-questions" target="_blank">http://erlang.org/mailman/listinfo/erlang-questions</a><br>
<br></blockquote></div><br></div></div>