I wouldn't have thought that to be an option, but now that you mention it - sure, sounds like a great idea.
Would you like me to do it? I'm not sure I have commit access to those pages...
I first would like to hear what other people think about, we are not in hurry;-)
Fine with me.
What's the proposal here? Insert this entity into every new PHP feature since PHP 4.2.0... forever? Every new function, constant, etc. will refer to this PEAR class? Eventually we will have a zillion "tips" for this optional
information and that will clutter up the manual.
Create a FAQ, put it in the migration docs, maybe even somewhere within the tutorial, but everywhere is too much information. IMHO of course :)
The full explanation should not be there on all pages. A small portion of text could be around on the relevant pages however, linking to that FAQ entry.
Goba
