On Fri, May 18, 2012 at 5:06 PM, H. S. Teoh <span dir="ltr"><<a href="mailto:hsteoh@quickfur.ath.cx" target="_blank">hsteoh@quickfur.ath.cx</a>></span> wrote:<br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On Fri, May 18, 2012 at 04:24:47PM -0600, Brad Anderson wrote:<br>
[...]<br>
<div class="im">> Also, I think std.algorithm could use a mini-FAQ.  std.range is long<br>
> overdue for an entire article explaining ranges but that's a well<br>
> known omission that pretty much everyone agrees on.<br>
<br>
</div>What about the latest prerelease docs for std.range? I did clean up a<br>
lot of stuff there and tried to explain the basic idea of what a range<br>
is, and included a link to Andrei's article that describes the idea of<br>
ranges in-depth.<br>
<br>
Or is that still not good enough? How can we improve the docs further?<br>
<span class="HOEnZb"><font color="#888888"><br>
<br>
T<br>
<br>
--<br>
Computers aren't intelligent; they only think they are.<br>
</font></span></blockquote></div><br><div>I like it.  Looks like it's already up on the website and was included with 2.059 unless there are further changes beyond what's on <a href="http://dlang.org/phobos/std_range.html">http://dlang.org/phobos/std_range.html</a></div>
<div><br></div><div>It's very clean now and the link to Andrei's article definitely helps. Also, good thinking linking to the print version instead of the difficult to read and confusing non-print version. People I link to Andrei's articles on InformIT sometimes don't realize there is more than one page.</div>
<div><br></div><div>It's a great improvement to the documentation. I do agree with Jonathan, though, that a official article on <a href="http://dlang.org">dlang.org</a> like Steven's arrays article would be a nice addition but what you've done helps enormously.</div>