<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On 11 March 2014 14:09, Dicebot <span dir="ltr"><<a href="mailto:public@dicebot.lv" target="_blank">public@dicebot.lv</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div class="">On Monday, 10 March 2014 at 15:08:07 UTC, Andrei Alexandrescu wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
On 3/10/14, 7:00 AM, Dicebot wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I still don't like disqus :)<br>
</blockquote>
<br>
Are there better such systems available?<br>
</blockquote>
<br></div>
I don't like the very concept of comments integrated with the docs and can't accept PHP example as authority. It just feels very intrusive<br>
<br>
wiki + stackoverflow + <a href="http://forum.dlang.org" target="_blank">forum.dlang.org</a> generate much more natural user documentation<br>
<br>
</blockquote></div><br></div><div class="gmail_extra">I don't like doc-integrated comments either.<br><br></div><div class="gmail_extra">A possible consequence is that people will simply stop improving the docs, because "workarounds" or extra explanations will be available in the comments.<br>

<br>Something like this happens in the AngularJS documentation, for example. There, the docs can be incomplete or even out of date, so you have to look at the comments.<br><br></div><div class="gmail_extra">Of course, if the docs are out of date regardless, this can be considered a good thing.<br>

</div></div>