#43465 [Asn]: function list is too long and incomphrehensible

From: 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

« previous php.doc.bugs (#317) next »