<div dir="ltr">Please do not create examples for _all_ entities in the API doc. In case of trivial entities [like Iterator::filter] it would just unnecessarily decrease the conciseness of the doc. Also: think about the amount of update this may make necessary in case Rust language syntax changes.<br>
<div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Jun 17, 2014 at 7:43 AM, Steve Klabnik <span dir="ltr"><<a href="mailto:steve@steveklabnik.com" target="_blank">steve@steveklabnik.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Thanks everyone! :D<br>
<div class=""><br>
> Steve, let us know how we can help.<br>
<br>
</div>I think the best thing that the community can do is go through and add<br>
examples in the API docs. I want to have 100% of the standard library<br>
having examples by 1.0, but it's last on my list. The reason is that<br>
they're nice, small chunks that can easily be tackled by others,<br>
whereas things like writing a whole tutorial are large, and take a<br>
while. I'd rather spend my time on those things first, and then get to<br>
the API stuff. But I can't tell you how valuable it is to look<br>
something up, and then cut and paste from the examples.<br>
<div class="HOEnZb"><div class="h5">_______________________________________________<br>
Rust-dev mailing list<br>
<a href="mailto:Rust-dev@mozilla.org">Rust-dev@mozilla.org</a><br>
<a href="https://mail.mozilla.org/listinfo/rust-dev" target="_blank">https://mail.mozilla.org/listinfo/rust-dev</a><br>
</div></div></blockquote></div><br></div></div>