There's been talk of allowing expanded pages within the documentation. For 
example, this page:

 - http://php.net/manual/en/reference.pcre.pattern.syntax.php

The basic idea would allow users to choose (for lack of a better term) "full 
page", which would then show every section from the above on one single page 
(like it used to be). Users can then use the familiar browser search functions, 
without having to click around.

A few issues and ideas:

 - User notes: Two solutions come to mind: A) Not show them B) Show them all, 
together, but with simple titled breaks.
 - How to generate: We'd likely generate these additional pages, but could 
re-factor our PHP output to do, for example, includes
 - UI for users: A) A link on these pages, e.g., 'expanded' B) Set default view 
type via my.php
 - Load the entire page in memory each time, using javascript to render desired 
chunks? (possible, but sounds wrong)
 - Translations: Some chunks might be translated, others not, not a big deal 
but worth mentioning
 - Please think of other problems/solutions/ideas

We've all used the 'new' style of the manual for awhile now and have likely 
come across issues/concerns, and the above appears to be the most common. Think 
of others, likely as new ML topics/threads. And maybe we should add a 
"suggestion box"?

Regards,
Philip


Reply via email to