(ii) Parameter List: I'd like to see this kept as compact as
possible, so I'd prefer to do without the vertical spacing
between the parameter name and its description. (Also, if it
were possible to merge the top and bottom dashed borders, that
would be great!) However, I would like to see the type
information repeated here, so I don't have to refer back to the
proto if the associated description doesn't make it obvious to
me (including an & if it's a by-reference parameter).
Type information and by reference passing should be included IMHO too. BTW the names of the parameters are missing from
http://livedocs.phpp.org/index.php?l=en&q=function.exif-thumbnail
(iii) The Change Log table has a rather wide first column -- this
may in part be due to the long title, which I think is excessive:
"Version" would be quite sufficient IMO.
Agreed. This title should be generated with an entity anyway.
(iv) Return Values: fine (but, as an aside, I'd question the wording
of this particular example -- I think it should be a general rule
to quote the principal return value first, with out-of-range
possibilities afterwards, so: "Returns the embedded thumbnail, or
FALSE if the image contains no thumbnail.")
Yup!
Overall this seems like the way to go.
Very much agreed!
Goba
