#43465 [Asn]: function list is too long and incomphrehensible
| From: | dave dot martin at office dot casema dot nl | Date: | Tue, 04 Dec 2007 10:38:50 +0000 |
| Subject: | #43465 [Asn]: function list is too long and incomphrehensible | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-316@lists.php.net to get a copy of this message | ||
ID: 43465
User updated by: dave dot martin at office dot casema dot nl
Reported By: dave dot martin at office dot casema dot nl
Status: Assigned
Bug Type: Documentation problem
PHP Version: Irrelevant
Assigned To: bjori
New Comment:
Bjori,
personally, I think thats fantastic. That URL shows me a whole
shedload of information about PHP which I didnt know before and which
isn't so upfront as I think it should be. I don't think it needs to be
presented as 'Membership' though. I think that term is unnecessarily
obscure.
I suggest:
Functions
Core Functions
Bundled Functions
Extended Functions
Again, personally, I think that's the way it should be presented
in the manual. It says a whole lot more about PHP than the way it is at
the moment.
Thats my feeling as a relative PHP newbie and as someone with more
than 20 years in the business. I could understand though that someone
with more experience who just wanted to quickly lookup the parameters
for a function for example, wouldn't want to drill through three or so
layers, but if there's a solution to this (a second access path, maybe
alphabetical), then this should be presented in a section afterwards or
as an appendix.
Previous Comments:
------------------------------------------------------------------------
[2007-12-04 09:37:45] bjori@php.net
We already have that list:
http://no.php.net/manual/en/extensions.membership.php
That list however was removed in the new reference structure, I suppose
we should add it in again.
------------------------------------------------------------------------
[2007-11-30 15:39:12] dave dot martin at office dot casema dot nl
@bjori,
It looks better. Personally I would still split it up into PHP Core and
Extended Functions.
It still take a lot of digging and its almost impossible to determine
the full capability of basic PHP here.
Session Handling - Everyone uses these and needs to know about them.
Not many are interested in Mohawk, muscat or SessionPgsql (I would
guess).
------------------------------------------------------------------------
[2007-11-30 14:46:33] bjori@php.net
We are working on restructuring the documentations, see
http://docs.php.net/funcref
http://docs.php.net/manual/en/refs.basic.text.php
Feedback is greatly appreciated.
------------------------------------------------------------------------
[2007-11-30 14:39:06] dave dot martin at office dot casema dot nl
Looking at it again, anything thats doesn' require external libraries
or special installation should be in e new section 'Extended Functions'
or something, and the Core stuff in 'Core Functions'
I might get to undertand what its all about!
------------------------------------------------------------------------
[2007-11-30 14:34:45] dave dot martin at office dot casema dot nl
Description:
------------
I really would like to see the docs split up into what's standard php
and whats not.
Particularly the functions. IF I want to know what I can do with
strings or arrays or booleans or collections or objects I dont want to
have to wade through LDAP functions or Monetary payment functions or
even Oracle or Sybase.
Any chance?
I can't see the wood for the trees at the moment!
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=43465&edit=1