[rest of original comments edited to shorten thread. btw, if my comment comes across as unkind or rude please pardon. it's not intended to come across this way. besides, text communication is one lowest form of communication.] i agree with robin. although it's true that other experienced QTR users did begin without much resources, but in all fairness all the frequently-asked-questions could've been spared from this forum had we have a cohesive manual and a glossary. much of the information is availabe in the manuals, but they're not presented cohesively. the user often have to connect the dots to make some sense of what the programmer is describing in the manual. i've written small manuals for a small company, and it's not an easy task. it's a challenge to take several sentences to describe a procedure and condense it down to a few steps without loosing the user. it's very easy to assume that the user understands your description and instructions because you already have in your mind how the product works. this is always easily overlooked when creating a manual for a product. if you've done technical writing for a product, i think you can sympathize with Roy and other programmers. it's not just step one, step two, and then step three. it's just as time consuming to design a program as it is to write a good manual. it's like an art, and so is writing a good program like QTR. with this said, i think a cohesive manual can become a reality when it's given fresh eyes from a user's perspective. i think this is what it needs. i'm a new user to QTR and i've toyed with the idea of writing a manual but backed-out. there are many other details about QTR that i don't understand yet. for me to try to write a manual may be counter productive because i may inadvertently misuse terminologies or describe procedures that contradicts Roy's original procedures. little details but important. so if anyone wants to improve on the manual, we'll have to put our heads together and agree on the terminologies and procedures. this way we can avoid any confusion which could trigger another mass of frequently-asked-questions populating this forum. i hope my comment made sense. regards, daniel --- In QuadtoneRIP@yahoogroups.com, "Rob" <robin@...> wrote: > > > I am going to have to strongly disagree with the last post--and I > have written a couple of computer books, including the first book on > how to do research on the Internet back in 95. I have also written > internal tip sheets at the company where I work. > > Those people with experience with the software rather than dismissing > new users could take the time to write a few paragraphs on a section > where they have a lot of experience or have special hints and upload > them to the file folders. Then after a check by other users, the > information can bue used to update the documentation. > > --- In QuadtoneRIP@yahoogroups.com, "dlruckus" <dlruckus@> wrote: > > > > Hi, > > While I'm sure it would be useful to nearly everyone beyond the > > experts in the field, it is worth considering how those experts got > to > > be that way. They did not have such a glossary either.
Message
Re: A Glossary Would Be Helpful
2007-03-09 by Daniel
Attachments
- No local attachments were found for this message.