> It is somehow confusing ... Yes, this is expected at this stage of phpdoc.
> 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 ;-) What fun would that be? But seriously, I'll be as blunt as possible so here's how I see it: 1) I don't know how to update the HOWTO on php.net and this was brought up once, summary: wait for docweb 2) Nobody knows when the upcoming phpdocweb site, codenamed "docweb", will be online. It however is where the updated php doc HOWTO will eventually always live. * http://doc.php.net/php/dochowto/ 3) The phpdoc.info site is a site maintained by some members of phpdoc and is not an official php.net project. It's a quick fix (and a nice one IMHO) to getting the job done. So in a perfect world docweb will be finished and the updated HOWTO will live there but this has not happened yet. Also in this perfect world docweb will have all the information phpdoc.info has. > 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 Compare the old style with the new style. Notice the old style all begins on column 2 (not flush left) while the new style starts at column 0 (flush left). I believe this extra whitespace got inserted when the manual had a huge banana split but anyway now you know. Do not mix whitespace changes with content changes...that's the point. I'll add some clarity to that Wiki now. Regards, Philip
