Coolest D features [OT] 1.0 celebrations

Chris Nicholson-Sauls ibisbasenji at gmail.com
Sat Dec 30 18:26:05 PST 2006


Georg Wrede wrote:
> Chris Nicholson-Sauls wrote:
>> Serg Kovrov wrote:
>>> Jeff wrote:
>>>
>>>> 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.
>>>
>>> Second that.
>>>
>>> PHP docs are well organized. Personally, I find it extremely 
>>> intuitive. As far as I remember, it takes near no time to find what I 
>>> want without knowing exact names or using search.
>>>
>>> Contrarily, Python docs are plain hell to work with.
>>>
>> I cannot count the number of times I've filled up a full instance of 
>> Firefox with a dozen tabs or so, all open to PHP doc files.  It is 
>> indeed intuitive.  (And the comments are often just as useful as the 
>> docs themselves!  For example: PHP has no is_assoc() to go along with 
>> is_array()... but look at the comments for the docs on is_array() and 
>> you can find a few examples of is_assoc() implementations right there.)
>>
>> I'd be quite jolly to see a similar approach to the D docs, along with 
>> the "as of version X" descriptors, etc.
> 
> Picture this: two guys, each with their own web site, compete on world 
> dominance on D documentation customer satisfaction. One is an absolute D 
> guru and an average PHP programmer, the other is an absolute PHP guru 
> and an average D programmer. Who'd you bet on? My bet's on the latter.
> 
> It's the infra that counts. But I'll come back to this once I've sobered 
> up from the D 1.0 champagne which I'll drink to instead of the New Year. 
> Too bad my local store doesn't carry Bollinger. ;-)

I went out and bought some Barenjager and Chartreuse for the occasion, myself.

-- Chris Nicholson-Sauls



More information about the Digitalmars-d mailing list