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

ID: 43465 Updated by: bjori@php.net Reported By: dave dot martin at office dot casema dot nl -Status: Assigned +Status: Closed Bug Type: Documentation problem PHP Version: Irrelevant Assigned To: bjori New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. The extension listing appendix ("membership" and "state" listing) has been re-added. The default listing (presented by /funcref) is the 'purpose' listing. Previous Comments: ------------------------------------------------------------------------ [2007-12-04 11:04:36] bjori@php.net 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. ------------------------------------------------------------------------ [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. ------------------------------------------------------------------------ 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