#43465 [Asn]: function list is too long and incomphrehensible
| From: | bjori@php.net | Date: | Tue, 04 Dec 2007 11:04:36 +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-317@lists.php.net to get a copy of this message | ||
ID: 43465
Updated by: bjori@php.net
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:
http://php.net/funcref does link to the extension
categorization page.
http://php.net/urlhowto explains ways to find
function/extensions
quickly.
Most people search for extensions/functions that they need. If the
extension is not enabled by default, or distributed via pecl, doesn't
matter. If you need it, you need it.
Previous Comments:
------------------------------------------------------------------------
[2007-12-04 10:38:49] dave dot martin at office dot casema dot nl
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.
------------------------------------------------------------------------
[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!
------------------------------------------------------------------------
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/43465
--
Edit this bug report at http://bugs.php.net/?id=43465&edit=1