“Bill Caroselli (Q-TPS)” <qtps@earthlink.net> wrote:
: Hi Steve
: Please be assured that my comments are meant to be constructive.
: You and your group are doing an excellent job. I started with QNX V2.
: There documentation sucked at best. More often it was non-existant. Over
: the years the QNX 4 documentation evolved to be very useful, and easy to
: use, both as a tutorial and for reference.
Thanks. I’m glad we’re making progress!
: I recognize, as others have already said in these newsgroups, that since I
: came from QNX background, many things in Nto/RTP are organized differently
: and therefore difficut for me to find then if I came from a Linux
: background. Little by little I’m catching on in learning where to look for
: what I need to know.
: Perhaps some links from where us QNX old-timers would look for things to
: where they are now located might help. I know that much of the
: documentation still needs to be written, but much of it IS THERE. It just
: seems to take forever for me to find what I’m looking for.
That’s a good idea. Any links in particular? It can be difficult for us
to know how our users look at the docs and where they expect to find things.
Finding things becomes more of a problem as the docs get bigger, so any
suggestions are most welcome.
: Also, I don’t know if it is my imagination or not but I find the global
: searches from the helpviewer to be less usful in RTP then in Q4. I figure
: that if I just don’t know where to look for something I should be able to do
: a global search for a phrase in EVERY document and sooner or later find it.
: With RTP I seam to get many more hits on my searches without actually
: finding what I am looking for.
I found the QNX 4 search rather slow; running grep on the docs was much
faster. I haven’t used the QNX 6 search very much. Perhaps others can
comment on it.
Most of the books have an online keyword index (generated from the same
tags as the index in the printed books) that might help.
: Regarding the fact that there is new software faster than you can document
: it, I guess that this is a mixed blessing. I dig new software/gimicks. But
: it does me no good if I don’t know it exists. Perhaps you should be willing
: to post help pages that are less then polished with a disclaimer at the top
: that this page is still a work in progress. I know that you do do that now
: for some pages.
: Another thought is that there are pages from QNX 4 that have never been
: “ported” to RTP. Why not just provide them with a disclaimer that they are
: for QNX 4 and should only be used as a guild but not be taken as reliable
: for the RTP version of software.
Those are possibilities, but we’d have to be careful. The quality of the
docs affects people’s perception of the quality of the software.
: Anyway, keep up the good work. We need you.
Thank-you, and thanks for the feedback.
(Now, did anyone answer your original question?)
Steve Reid stever@qnx.com
TechPubs (Technical Publications)
QNX Software Systems