On Dec 5, 2007, at 5:23 AM, Keryx Web wrote:
Hi
Today I polluted the internals list with an off topic remark about
Front End code quality. I quote myself:
[Off topic rant]
I am constantly amazed that some PHP-wizards, whose knowledge of
back-end development clearly shows in how many ways I must still be
considered an newbie, are very unaware about what has been going in
on the front end this century, with regards to accessibility,
standards, unobtrusive scripting, semantic (X)HTML, CSS-based
design, etc.
[/rant]
Now, things might improve if the manual nudged people in the right
direction. I am not thinking about teaching HTML or CSS, but doing
the small right things in all examples.
E.g. This page: http://docs.php.net/manual/en/introduction.php
The HTML in "An introductory example" should have a DOCTYPE. And
always a strict version of either HTML 4.01 or XHTML.
I will in a separate mail submit text that may improve this page:
http://docs.php.net/manual/en/tidy.examples.php
Lars: If you "speak" XML, and have a strong, critical, eye for
ensuring that documentation is both complete *and* concise, you're
more than halfway to becoming one heck of a documentation author for
PHP.
Have you considered helping out? It's one heck of a resume/
recommendation builder.
Some starting points:
http://doc.php.net/php/dochowto/
http://doc.php.net/wiki/
--ronabop
