#45256 [Fbk->Opn]: Regular expression navigation regression
| From: | dclayton at serif dot com | Date: | Mon, 16 Jun 2008 07:42:57 +0000 |
| Subject: | #45256 [Fbk->Opn]: Regular expression navigation regression | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-888@lists.php.net to get a copy of this message | ||
ID: 45256
User updated by: dclayton at serif dot com
Reported By: dclayton at serif dot com
-Status: Feedback
+Status: Open
Bug Type: Documentation problem
Operating System: N/A
PHP Version: Irrelevant
New Comment:
Yeah, I'm not saying I can't find the documentation - I just think it
could be tweaked so that if you're at any of the reg ex function pages,
you can get straight to pattern modifiers and syntax. 3 clicks to syntax
is a hassle because it's a page you very often want to get to straight
from the preg_* functions :)
It's not a huge deal though, if it's not going to change I'll just have
to remember to bookmark the modifier/syntax pages. In general the php
documentation is pretty damn good, much better than MSDN (blurgh!)
Previous Comments:
------------------------------------------------------------------------
[2008-06-13 15:11:41] philip@php.net
The main pcre page is here:
* http://php.net/book.pcre
It lists everything and all the preg_ pages link to it. However, there
is a bug that on some mirrors has this:
* http://php.net/pcre
Wrongly take us to:
* http://php.net/ref.pcre
Instead of book.pcre... And there is already a bug report about having
this within the sidebar although I'm unsure how deep we want the links
to go there but:
* http://bugs.php.net/44735 (nav bar)
* http://bugs.php.net/45060 (ref vs book)
------------------------------------------------------------------------
[2008-06-13 07:35:33] dclayton at serif dot com
Actually strike that - it is now *3* clicks to get to pattern syntax :(
------------------------------------------------------------------------
[2008-06-13 07:32:01] dclayton at serif dot com
Description:
------------
There was a change made to the regular expression documentation
recently, whereby it is now 2 clicks to get to the "PCRE" modifiers and
syntax. Normally a change like this wouldn't bother me, but regular
expressions are a core part of web development and I use them
extensively. Whenever I want to look up a regular expression, I often
will start at one of the preg_* functions to check the argument order,
etc., then go to the regex pattern parts of the documentation to check
the expression itself.
In summary, this is somewhat subjective but I personally believe moving
the pattern modifiers and syntax from the navigation pane you get in the
regular expression functions docs was a regression in the site's
navigation structure. I would sincerely appreciate it if some way could
be found to move them back, as they are vitally useful and it wouldn't
surprise me at all if they were one of the busier pages on the site :)
Reproduce code:
---------------
N/A
Expected result:
----------------
N/A
Actual result:
--------------
N/A
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=45256&edit=1