[fpc-devel] [RFC] fpdoc output comment from the source

L L at z505.com
Sun Dec 18 14:44:15 CET 2005


> under the documents (who wouldn't?).
>
> The author, for one :-)
>
> The commenting system puts extra load on the server which I don't want.


Amazon.com has a patent on one click shopping, I believe. I think I know why.

Well, with the FindPart function, back 7 months ago.. I found an error in the docs
regarding the Result/Return value. I reported it - but was too lazy to submit a
patch. And guess what, the findpart error in the documentation is still there today,
7 months later.

Wait a minute - *lazy* is actually the wrong word. Forget I said lazy. I'm far from
lazy. I'm a hard worker. And yet my animal instinct still tells me that making a doc
patch via the current setup, or adding a comment via the current setup, is not
natural. My instinct, as an animal, is to leave the error in the docs and move on to
other things. It's not one click shopping.

My instinct, as an animal, when I arrive at the PHP website, is to correct the docs
if I see an error. It's one click shopping.

--
L505
Mammal




More information about the fpc-devel mailing list