Re: developers manual and users manual
| From: | Friedhelm Betz | Date: | Sun, 11 Aug 2002 23:20:03 +0000 |
| Subject: | Re: developers manual and users manual | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969348009@lists.php.net to get a copy of this message | ||
Hi all,
Monday, August 12, 2002, 12:24:52 AM, you wrote:
> Not sure if people using PHP for development will be
> confused, in particular if we have a:
> "PHP Users Manual" and a "PHP Developers Manual"
> Other software projects use different approaches, e.g.
> Python (http://www.python.org/doc/) where the
> different bits are separated, whereas the PostgreSQL
> has 2 top level sections "User's Lounge" and
> "Developer's Corner", perhaps a separation like that
> can clarify who are the target audience for the docs.
+1 @goba for his suggestion of splitting
+1 @jesus for "PHP Users Manual" and a "PHP Developers Manual"
-1 @goba and @jome for "PHP Inner Workings Manual" sounds horrible in my
ears ;-)
> --- Jome <jome@emoj.net> wrote:
>> > Well, I know about this "PHP Developer" problem...
>> While this is not
>> > a problem for eg. MySQL, where it's clear who is a
>> user and a developer,
>> > it's not that simple for PHP... Maybe we can leave
>> the PHP Manual as
>> > it is know and just name that new manual with a
>> good title, such as
>> > "PHP Inner Workings Manual" or something like that
>> just to avoid
>> > confusion...
>>
>> Sounds like a good idea.
>>
>> Regards,
>>
>> Jome
Friedhelm