php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #37718 Patterns page has not a single bit of info on PHP
Submitted: 2006-06-06 19:52 UTC Modified: 2006-06-08 14:42 UTC
Votes:2
Avg. Score:3.0 ± 0.0
Reproduced:1 of 1 (100.0%)
Same Version:1 (100.0%)
Same OS:1 (100.0%)
From: phpbugs at localpin dot com Assigned:
Status: Wont fix Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Developer Edit
 [2006-06-06 19:52 UTC] phpbugs at localpin dot com 
Description:
------------
I am a great fan of patterns, but nonetheless I do not think that the following patterns page has ANY place in the PHP documentation DESCRIBING THE PHP LANGUAGE.  It may be really great information, it may all be perfectly true, and a great way to program in PHP, but it is my assertion that it does not have a SINGLE piece of information which actually in any way describes the FUNCTIONALITY of PHP5.

http://www.php.net/manual/en/language.oop5.patterns.php

Expected result:
----------------
I would like to see this page DELETED from the PHP5 documentation.

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2006-06-06 20:47 UTC] derick@php.net 
Request DENIED.
 [2006-06-08 13:27 UTC] phpbugs at localpin dot com 
Why denied?  Can you tell me a single thing on this page which is actually relevant to the PHP documentation?
 [2006-06-08 13:40 UTC] simp@php.net 
I have to agree with derick.
That part of the documentation does not introduce features specific to PHP but displays how to implement common paterns with php. IMO that's worth a discussion in the PHP manual.
 [2006-06-08 14:42 UTC] phpbugs at localpin dot com 
I fully agree that this information is useful and worth a discussion in the PHP manual.

But I vehemently disagree that this has anything to do with "Language Reference" (the section that it is in) or that it describes anything at all that is part of the language of PHP5.

I am a humble user of PHP who was reading the PHP5 language reference section to try and understand those features which are PHP5 SPECIFIC.  I was completely confused by this page, as I tried to understand what it was which was a PHP5 specific thing.  

What is there about patterns which do not apply to PHP4?  

What is the PHP5 language feature that this page describes?  This is supposed to be the Language Reference.  It's not a place to put whatever things you think are great ways to program PHP.

If you really wish to keep this page, then at the very least it should be moved to a different section, perhaps as a page in the Appendix "Using patterns in PHP".

It is not about PHP5.  It has no place in the Language Reference section.

Keep it if you will, but please NOT in the PHP5 Language Reference section.
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved. 		Last updated: Thu Dec 26 18:01:31 2024 UTC