From: chealer at gmail dot com
Operating system:
PHP version: Irrelevant
Package: Online Doc Editor problem
Bug Type: Bug
Bug description:Misleading Edit button (Experimental but not flagged as such)
Description:
------------
I noticed tens of issues in PHP documentation over the years. Sometimes,
I tried to get them fixed. I opened bug reports, and about 5 times I
must have tried to use "Php Docbook Online Editor".
Unfortunately, to my knowledge none of my attempts to fix the doc with
Php Docbook Online Editor worked. I had such a strong suspicion that the
last 2 attempts, I noted what I did to confirm.
As reported in http://news.php.net/php.doc/969385815 I submitted a
proposal in 2015 for addslashes which was not accepted. It appears that
this proposal is completely lost. I cannot even find any evidence that
it was made. I reported this to the phpdoc mailing list years ago and
did not get any answer:
http://news.php.net/php.doc/969385815
Some time later, as I did not trust Php Docbook Online Editor, I
submitted issue report #70120:
https://bugs.php.net/bug.php?id=70120&edit=2
Unfortunately, the page still has several issues, so I tried to use Php
Docbook Online Editor once again to actually solve the issue on
2016-03-26, but that time I took notes. And unfortunately, over 2 years
later, my proposal is neither accepted, nor even acknowledged in any way
that I can see. I did not receive any email, which is not surprising
given that I was not asked for an address.
So once again, the Edit button which seems to suggest the documentation
is a wiki misled me. I thought I could edit easily, but in fact I put my
time in the garbage.
I am guessing that Php Docbook Online Editor is not completely broken,
so I am not going to suggest dismantlement, but at least one of the
following should be done:
1. Make it less likely that contributors reach Php Docbook Online Editor
from the documentation. Either remove the link, move it somewhere less
prominent, or change the label ("Propose a change / Edit" would already
be less misleading).
2. Implement basic features and do minimal quality assurance to confirm
that these features work.
3. Add a warning when launching Php Docbook Online Editor that it is
experimental, or - better yet - list the main areas known to be broken.
--
Edit bug report at https://bugs.php.net/bug.php?id=77348&edit=1
--
Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=77348&r=trysnapshot54
Try a snapshot (PHP 5.5): https://bugs.php.net/fix.php?id=77348&r=trysnapshot55
Try a snapshot (trunk): https://bugs.php.net/fix.php?id=77348&r=trysnapshottrunk
Fixed in SVN: https://bugs.php.net/fix.php?id=77348&r=fixed
Fixed in release: https://bugs.php.net/fix.php?id=77348&r=alreadyfixed
Need backtrace: https://bugs.php.net/fix.php?id=77348&r=needtrace
Need Reproduce Script: https://bugs.php.net/fix.php?id=77348&r=needscript
Try newer version: https://bugs.php.net/fix.php?id=77348&r=oldversion
Not developer issue: https://bugs.php.net/fix.php?id=77348&r=support
Expected behavior: https://bugs.php.net/fix.php?id=77348&r=notwrong
Not enough info: https://bugs.php.net/fix.php?id=77348&r=notenoughinfo
Submitted twice: https://bugs.php.net/fix.php?id=77348&r=submittedtwice
register_globals: https://bugs.php.net/fix.php?id=77348&r=globals
PHP 4 support discontinued: https://bugs.php.net/fix.php?id=77348&r=php4
Daylight Savings: https://bugs.php.net/fix.php?id=77348&r=dst
IIS Stability: https://bugs.php.net/fix.php?id=77348&r=isapi
Install GNU Sed: https://bugs.php.net/fix.php?id=77348&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=77348&r=float
No Zend Extensions: https://bugs.php.net/fix.php?id=77348&r=nozend
MySQL Configuration Error: https://bugs.php.net/fix.php?id=77348&r=mysqlcfg