New, useless CHM Doc Format
| From: | Thomas Hörnke | Date: | Sat, 29 Jun 2013 11:06:59 +0000 |
| Subject: | New, useless CHM Doc Format | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969384495@lists.php.net to get a copy of this message | ||
Dear Doc Maintainers,
I am a quite experienced (~ 15 years), professional PHP developer. Ever since, I have been a heavy
user of the chm doc format, greatly appreciating the index, the search, the favorites, the left-side
tree navigation.
I'm not updating my local version of the chm doc every day or week, so the changes I'll
complain about now might not be the most recent ones.
The last version I was quite happy with had of course the section "function reference",
grouped into different subsections.
Sadly, I have now overwritten my local version with the new version that is offered online.
In this new version, the "function reference" is a mere page, of course with the docs
still linked, and thus, reachable _somehow_, but:
* None of the functions in the whole function reference is to be found via index search
* In the full text search, the hits in the result list now are _not_ bearing the function name,
but some kind of document title.
The search for "id3_get*" i.e. doesn't show any result starting with
"id3_get", but instead the descriptive name.
This descritpive document title is mostly useless: too long to be displayed in a
smaller window, bad translations in localized doc versions
* Of course, the very convenient and informative left column tree view of whole packages is gone
:(((
And with it the feature, that, if you click a hit in some result list or in the index, the tree
navigation will follow - and bring you to the appropriate section/subsection, to find out more about
the context of the function you have been looking for. Very very very convenient and useful, that
was ...
I really hope so much that you bring back the real useful previous format of chm doc with one of the
next doc updates - but, honestly, I am afraid that some purist nerds talked you into the current
format, with arguments like .. hm, what arguments can one bring forward to enforce such a dramatical
degradation of usability?
It was useful. It was helpful. It made my work effective. All that is missing in the current chm
doc version.
So, my cry for help is this:
Please tell me, where I can find the latest version of a PHP documentation in CHM format, with a
real usable function reference, with real index search, with left col tree navigation within the
function reference, and all the stuff I mentioned above. English or german version, with or without
annotations - I don't care, as long as I can have a usable documentation.
Thank you so much in advance,
best regards
Thomas
______________________________________________
Thomas Hörnke
h3:: henning hörnke & partner
Mediendesigner und Anwendungsentwickler
Reichenberger Str. 35, 10999 Berlin
tel 030 695 68 188 / 0163 695 68 91
fax 030 616 27 509
t.hoernke@h3berlin.de
www.h3berlin.de
Steuernummer 14/326/61903
Sitz der Gesellschaft: Berlin
Amtsgericht Charlottenburg, PR 274 B
______________________________________________