Re: Re: Pear documentation
| From: | Markus Fischer | Date: | Tue, 09 Oct 2001 23:19:50 +0000 |
| Subject: | Re: Re: Pear documentation | ||
| Groups: | php.pear.dev | ||
| Request: | Send a blank email to pear-dev+get-2214@lists.php.net to get a copy of this message | ||
Just adopt the existing standards. Ie, check out the current
php.net doc und pearify it. Or use php-gtk-doc. Or even ZendAPI
doc. All are using docbook. If no one in 'our' ;) team can do it,
I'm sure we can request help from someone who knows better (James
Moore comes into my mind but I'm sure there are others too)
- M.
On Tue, Oct 09, 2001 at 05:32:26PM +0200, Martin Jansen wrote :
> On Tue, 09 Oct 2001 17:21:17 +0200, Tomas V.V.Cox wrote:
>
> >Martin Jansen wrote:
> >>
> >> On Tue, 09 Oct 2001 15:26:05 +0200, Tomas V.V.Cox wrote:
> >>
> >> >In what areas are you interested in? DocBook would be the best format,
> >> >but plain text or html are also good. Any way please go ahead :-),
> >>
> >> Well, at least we should concentrate on one format. My favourite is
> >> Docbook, since you can generate a bunch of other formats from it.
> >>
> >
> >First we should concentrate on generating doc :-). My recommendation is:
> >"Seriously think on using DocBook, but if don't want it, rethink it and
> >if finally don't want it choose other "on-line displayable" format like
> >plain text or html". Is it a good approach?
>
> But how do you want to publish all this different formats on the
> PEAR website? If we want to have a centralised solution for the
> documentation, we'll have to conclude on one standard IMO.
>
> - Martin
>
>
>
> --
> PEAR Development Mailing List (http://pear.php.net/)
> To unsubscribe, e-mail: pear-dev-unsubscribe@lists.php.net
> For additional commands, e-mail: pear-dev-help@lists.php.net
> To contact the list administrators, e-mail: php-list-admin@lists.php.net
--
Markus Fischer, http://guru.josefine.at/~mfischer/
EMail: mfischer@guru.josefine.at
PGP Public Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
PGP Fingerprint: D3B0 DD4F E12B F911 3CE1 C2B5 D674 B445 C227 2BD0
-All your scripts are belong to Zend-