Jean Hollis Weber wrote: > The point is that even if a document makes total sense to the person who > wrote it (and to others who may have used or reviewed it), if some other > people (at least one of whom is not totally technically challenged) have > trouble with it, then the document is *not* as clear and unambigious as the > writer thinks. It fails the "suitable for the target audience" test.
I'd like to add that this is why OOoAuthors has a peer review process. A writer makes a document that makes perfect sense to her. A reviewer then picks it up and finds a dozen things that are completely obscure to him. Those are fixed. Then a second reviewer picks it up and finds another 6. Each chapter is reviewed roughly 4 times, by 4 different people. When they are all happy with the document, we send it to Jean or Janet for another review. When it comes out, we can be fairly confident that it will be understandable to most people. Cheers, -- Daniel Carrera | I don't want it perfect, Join OOoAuthors today! | I want it Tuesday. http://oooauthors.org | --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
