Re: improving the manuals

on 9/07/01 14:14, Hojtsy Gabor at goba@php.net wrote: > Hi! > > Sorry, I am messed up a bit now... I am really angry > about that Exchange server converting all my letters > to HTML... > > This questions is appropriate for _Damien Seguy_. He > has developed a somewhat better doc system at nexen.net > (see the links on the docs.php page), and we would be > happy to see his improvements in the official docs... Here am I. Let's start by putting that the "better" doc system is my very opinion, which include some pride from this work. I do understand that those suggestion may not fit PHP.net website. Here are a list of improvements added, available on Nexen.net site (http://dev.nexen.net/docs/php/annotee/) : All is in French... + dynamic summary, with tree-like arborescence (using cookie) + improved search engine, with function name search, keyword search (using user's best choice as pertinence) + several indexes : functions, examples, extensions and concepts. + annotations in French + links from each function to PHP function's librairy, so as to provide numerous examples for about 2/3 of functions + email docs to a friend + Changelog (experimental) + Fast references for functions, usage and parameters. All of those are not suitable for PHP.net. I suggest that the one that are interested (such as Goba), take a look at the mentionned URL. I'm available to answer questions about this. I'm currently updating MySQL French documentation,to reach the (almost) same level of functionality, but I'll be available soon to work on phpweb too.. My two cents. Damien Seguy