Doc #65699 [Opn->Csd]: Problem in comment section for end() documentation
| From: | aharvey@php.net | Date: | Fri, 20 Sep 2013 19:58:46 +0000 |
| Subject: | Doc #65699 [Opn->Csd]: Problem in comment section for end() documentation | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-10285@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=65699&edit=1
ID: 65699
Updated by: aharvey@php.net
Reported by: joem at numberfour dot eu
Summary: Problem in comment section for end() documentation
-Status: Open
+Status: Closed
Type: Documentation Problem
Package: *General Issues
PHP Version: Irrelevant
-Assigned To:
+Assigned To: aharvey
Block user comment: N
Private report: N
New Comment:
I've removed the note. Thanks.
To be clear, CHM documentation is down because nobody has the knowledge and time
to fix it. We'd greatly appreciate help on that one.
Previous Comments:
------------------------------------------------------------------------
[2013-09-18 17:17:48] gabri dot ns at gmail dot com
well... thats the rule given by the documentation team.
by the way, if you keep asking about this, it is possible
that they will also closing down the user note feature,
just like they did with chm documentation when there is
so much report about it, without even checking that there is
a lot other same report.
i will not respond any further. if you still need help,
open http://www.php.net/support.php and ask there. or
you
could drop me an email.
------------------------------------------------------------------------
[2013-09-18 17:11:16] joem at numberfour dot eu
That is not a good enough way to correct misleading comments because it doesn't
explain why it is wrong.
------------------------------------------------------------------------
[2013-09-18 17:07:21] gabri dot ns at gmail dot com
report bug if you find problem with php or documentation,
not with comment or user note.
if you see comments with bad information, give it a vote down.
------------------------------------------------------------------------
[2013-09-18 16:58:41] joem at numberfour dot eu
Right, however the comment instructions say not to refer to other comments. They
also ask to file a bug if there are any problems. That comment clearly will lead
some people down a buggy path and so should be corrected/deleted/added to.
What is the correct thing to do when you see comments with bad information?
------------------------------------------------------------------------
[2013-09-18 16:55:00] gabri dot ns at gmail dot com
first off all, comment section is not part off documentation.
its just a means for user to share knowledge. if its usefull,
it is possible to include it to the documentation.
secondly, don't trust any off code in it, since it maybe coded
in different environtment with yours. try it yourself...
if it work, take it. if don't, leave it. or may be you can read
the documentation to find the problem with the code, yourself.
don't report it here. if you need help, open http://www.php.net/support.php
and join one of available option there.
lastly, try open http://www.php.net/references and
http://www.php.net/array_pop to find the source of evil
from the code.
regard,
gabri
------------------------------------------------------------------------
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
https://bugs.php.net/bug.php?id=65699
--
Edit this bug report at https://bugs.php.net/bug.php?id=65699&edit=1