RE: [PHP-DEV] FAQ URL updates for next php3 release
| From: | Colin Viebrock | Date: | Mon, 07 Jun 1999 15:05:06 +0000 |
| Subject: | RE: [PHP-DEV] FAQ URL updates for next php3 release | ||
| References: | 1 | Groups: | php.dev |
| Request: | Send a blank email to php-dev+get-6643@lists.php.net to get a copy of this message | ||
Rasmus and I spoke (a long time ago it seems) about moving
the PHP documentation at least into it's own CVS tree, and at the
most into some web-based database updateable template thingy.
Obviously we spoke of it in very technical terms.
I think his thinking was that since the SGML format of the manual
is almost identical page to page (i.e. every function page follows
the same template), why not build a web-interface that that
lets us edit/add/update manual entries through the web, then
parses it into the appropriate SGML and stores it in a CVS tree
or database.
Someone needs to build this, of course. It may well be me, but
certainly not before the end of August (big holiday coming up).
Thoughts?
__________________________________________________________________
Colin Viebrock easyDNS Technologies
... be the master of your domain
http://www.easyDNS.com
> -----Original Message-----
> From: Stig Bakken [mailto:ssb@fast.no]
> Sent: Monday, June 07, 1999 8:19 AM
> To: Jim Winstead
> Cc: Paul Andersen; php-dev@lists.php.net
> Subject: Re: [PHP-DEV] FAQ URL updates for next php3 release
>
>
> On Sun, 6 Jun 1999, Jim Winstead wrote:
>
> > Well, I think having a standalone FAQ is good. People expect it,
> > even if it seems like a lot of people don't read it (although it's
> > been read from www.php.net over 3000 times already this month).
> > (And I would suspect that even fewer actually read the manual.)
> >
> > But everything that is in the FAQ should definitely be in the
> > manual someplace, too. This may not be the case now.
>
> IMHO the phpdoc repository should contain the FAQ, in SGML format, so we
> can use the same tools to generate different formats.
>
> - Stig
>
>
> --
> PHP Development Mailing List (http://www.php.net/)
> To unsubscribe, e-mail: php-dev-unsubscribe@lists.php.net
> For additional commands, e-mail: php-dev-help@lists.php.net
> To contact the list administrators, e-mail: php-list-admin@lists.php.net
>