Date: 06/24/01
- Next message: Thomas Schöfbeck: "[PHP-DOC] cvs: phpdoc / make_chm.bat"
- Previous message: Hojtsy Gabor: "Re: [PHP-DOC] Re: [PHP-DEV] About ext/sockets/"
- In reply to: Daniel Beckham: "Re: [PHP-DOC] cvs: phpdoc /en/functions var.xml"
- Next in thread: Zak Greant: "Re: [PHP-DOC] cvs: phpdoc /en/functions var.xml"
- Reply: Zak Greant: "Re: [PHP-DOC] cvs: phpdoc /en/functions var.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
> I don't think it's necessary to quote the developers when writing
> documentation. Many people probably have no idea who Andi is and it's
even
> (very remotely) possible that he may not be involved in PHP development in
> the future. The PHP docs are the definitive source for PHP documentation
> and they already indirectly reflect the ideas and thoughts of the
> development team, without having to quote them. Besides, the
documentation
> should be written in a confident style without having to support itself
with
> quotes or references.
>
> What do you guys think?
> > + Note that the PHP resource type is not considered a scalar value.
> > + Andi Gutmans states: "[Resources] are abstract datatypes which
> > + happen to be in ID (integer) form ... people should [not] count
> > + on it being an integer as this could change one day."
Yes, you are right, that the average PHP programmer
will just be confused about why Andi's name is there...
Goba
- Next message: Thomas Schöfbeck: "[PHP-DOC] cvs: phpdoc / make_chm.bat"
- Previous message: Hojtsy Gabor: "Re: [PHP-DOC] Re: [PHP-DEV] About ext/sockets/"
- In reply to: Daniel Beckham: "Re: [PHP-DOC] cvs: phpdoc /en/functions var.xml"
- Next in thread: Zak Greant: "Re: [PHP-DOC] cvs: phpdoc /en/functions var.xml"
- Reply: Zak Greant: "Re: [PHP-DOC] cvs: phpdoc /en/functions var.xml"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

