Hi Cornelia,
It is somehow confusing ...
Two days (?) ago there was an advice to go to
http://wiki.phpdoc.info/DocSkel because the HOWTO is somewhat outdated. Now the advice to use the HOWTO at either php.net/dochowto or http://doc.php.net/php/dochowto/index.php ...
Why is important stuff spread on different websites and which one contains the latest versions? In my opinion this doesn't make things easier. Especially for new people.
Wouldn't it be better to put all doc-related stuff on one place. I think maintaining three sites is more effort than keeping track on one ;-)
Yes, it would definitely be better. I can hand out CVS write access to those, who are willing to contribute to the doc.php.net website, which is supposed to be this very place. The doc website team has a mailing list, but sadly only a few people are active.
http://news.php.net/php.doc.web
BTW, I don't understand what this means: http://wiki.phpdoc.info/DocSkel/MigrationStatus?v=d8i
When migrating a reference, please separate your CVS commits :
* a commit for whitespaces (remember that the new docs starts at col 0) * a commit for the actual migration
It is easier to human-review a file, if it only contains actual changes (no whitespace changes). Whitespace changes will surely be dismissed by those, who are keen on looking out what was changed, actual changes are sometimes reviewed.
Goba
