Re: svn: /phpdoc/ doc-base /trunk/entities/global.ent doc-base/ trunk/manual.xml.in en/trunk/referen ce/cubrid/book.developer.xml en/trun
k/reference/cubrid/book.xml en/trunk /reference/cubrid/configure.xml en/t runk/reference/cubrid/consta
| From: | Hannes Magnusson | Date: | Thu, 05 Aug 2010 11:37:50 +0000 |
| Subject: | Re: svn: /phpdoc/ doc-base /trunk/entities/global.ent doc-base/ trunk/manual.xml.in en/trunk/referen ce/cubrid/book.developer.xml en/trun k/reference/cubrid/book.xml en/trunk /reference/cubrid/configure.xml en/t runk/reference/cubrid/consta |
||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-6962@lists.php.net to get a copy of this message | ||
2010/8/5 에센 사그노브 <esen.sagynov@nhn.com>:
> Dear Hannes,
>
> Thanks a lot for your quick feedback. It's very vital for rapid development and
> contribution.
>
> 1. You say "book.develop.xml" is usually not committed. Do you want me to
> remove that file?
That file is very useful for quickly building only that part of the
docs.. but since no other extensions have it, I think it should be
removed yes.
> 2. I will replace tabs with single spaces.
> 3. "configure.xml" will be fixed.
> 4. "entities.functions.xml" file will be removed.
> 5. In "examples.xml" and everywhere else will no longer use short opening
> tags.
> 6. Examples will comply the PEAR CS.
Kudos
> We will update the docs by tomorrow. After that, if you have any comments, please send me your
> feedbacks. Will the documentation be available at PHP Docs (http://www.php.net/manual/en/index.php)?
> I will need to update
>
The docs will be automatically available online around 3pm UTC
tomorrow - and are updated every week around that time.
> I would also be glad if you told the next steps we should take to move this process forward.
Well.. there is very little left to do - quickly scanning the docs,
they seem very good. There are various things that could be done
better XML wise, for example use <constant>CONSTANT_NAME</constant>
and minor things like that.
I'm sure someone will browse the docs and provide suggestions for
changes if there is something that can be done better.
We have a "special mirror" on http://docs.php.net/manual that updates
the manual 4times per day, so you could browse the docs there in
couple of hours to see how it will turn out :)
-Hannes