#36533 [WFx]: Need for user notes in downloadable HTML documentation
| From: | mathieu dot bonnet at nalkym dot org | Date: | Sun, 26 Feb 2006 13:06:29 +0000 |
| Subject: | #36533 [WFx]: Need for user notes in downloadable HTML documentation | ||
| References: | 1 | Groups: | php.mirrors |
| Request: | Send a blank email to php-mirrors+get-30683@lists.php.net to get a copy of this message | ||
ID: 36533
User updated by: mathieu dot bonnet at nalkym dot org
Reported By: mathieu dot bonnet at nalkym dot org
Status: Wont fix
Bug Type: Website problem
PHP Version: Irrelevant
New Comment:
I like the idea, but it is slow and needs a Web server (well, I have
one, but I would prefer not to depend on it, for the
documentations...). Moreover, the table of contents is too detailed in
the default configuration. Unfortunately, for now, I don't have enough
time to try to tweak it.
I won't insist, if you do not want to generate another version of the
downloadable HTML documentation, but I still think it is the best
solution, for most people, for now.
Previous Comments:
------------------------------------------------------------------------
[2006-02-26 11:54:30] goba@php.net
What you are looking for (also with the search box :) is a self-hosted
packages, which includes user notes. We are in a great need of testers
for our Livedocs software, which does just that, and it looks really
nicer then the downloadable HTML versions.
http://wiki.phpdoc.info/LiveDocs
You will find the self-hosted version on the first link. Please give
feedback, bug reports and suggestions in the Livedocs bug category.
------------------------------------------------------------------------
[2006-02-26 10:37:01] mathieu dot bonnet at nalkym dot org
Description:
------------
The PHP downloadable HTML documentation does not feature the user
contributed notes. I can understand some people do not want them, but
it would be nice to have a separate downloadable HTML documentation
version, with the user contributed notes.
As the user notes are in English, I guess we only need the English
documentation to be available with them... and I suppose we only need
the version with multiple HTML files.
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=36533&edit=1