Re: developers manual and users manual
| From: | Steph | Date: | Mon, 12 Aug 2002 06:19:32 +0000 |
| Subject: | Re: developers manual and users manual | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969348011@lists.php.net to get a copy of this message | ||
+1 for splitting
-1 for 'PHP Developers' Manual' vs 'PHP Users' Manual', there is a
huge
amount of confusion about this as we all know. Other software projects
don't generally have the same issue with this ..
'PHP Sourcerers' Manual' vs 'PHP Manual'? - we need something _that_
obvious IMHO.
> 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.