On 9/29/07, Edward Z. Yang <[EMAIL PROTECTED]> wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > Hannes Magnusson wrote: > > docs.php.net has been update; http://docs.php.net/manual/en/funcref.php > > Things to pay attention to: XMLReader, Reflection and the navigation. > > Wow, this looks fantastic! > > Quick notes from looking at: > http://docs.php.net/manual/en/class.reflectionfunction.php > > - - The ReflectionFunction sub-pages don't expand on the side until you > navigate to a sub-page: not good
The class reference pages are just like regular reference pages, when you go to php.net/strings or php.net/network (or any other reference page) the "sibling references" are listed on the left while the children pages are at the bottom. I really think we should be consistent here and not add any special treatment for class reference pages. > - - The method declarations are a bit wordy. Can we try to reduce them to > // defining class ... declarations? I'm not following, you mean removing the return values/parameters from the class definitions? > - - I'm not sold on the idea of deep nesting the extension categories, > maybe this will change I totally agree, we should not be nesting extensions categories to deeply - which is why there is not deep nesting. By putting extensions in categories we only list the extensions which are relevant to the extension which we are currently viewing. I.e., when looking at the XMLReader reference page we only see XML extensions on the left rather than all the 30 database extensions and 70 other totally unrelated extensions (as we currently have) -Hannes
