Coolest D features

[Pragma]

Jeff wrote:
> On 2006-12-29 15:12:41 -0800, Brad Anderson <brad at dsource.org> said:
> 
> I am not very impressed by Python's docs.  The best docs that I've seen 
> are the PHP docs because of commenting and excellent examples.
> 
> -- Jeff
> 

I agree with this %300.

What I find most humorous about PHP is that it *needs* good 
documentation because the "API" is so horribly fragmented - they kept 
the import names and call signatures from all those C libs, rather than 
normalize them.  The doc-comments feature was also a must-have since the 
documentation provided was (and in places, still is) anything but 
adequate on it's own.

The only major fault in the PHP doc web is that the documentation isn't 
ever really updated *from* the user provided comments.  You'd think an 
editor would gather up all the corrections and examples and fold them 
in, rather than let them hang out there for years on end?  I've seen 
some threads where the oldest posts are mis-information of the worst 
kind due to them dating back to PHP 3.0.

Another example: the ColdFusion docs do have editors that upgrade/update 
the system regularly.  However, they like to wipe out *everything* 
between language versions on their website - they're separate webs after 
all.  The result is the CF5, CFMX6 and CFMX7 doc webs all have different 
user content.

-- 
- EricAnderton at yahoo