#45256 [Fbk->Opn]: Regular expression navigation regression

From: 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

« previous php.doc.bugs (#888) next »