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