On Thursday, February 16, 2017 at 3:14:33 PM UTC-6, Edward K. Ream wrote: > On Thursday, February 16, 2017 at 10:47:01 AM UTC-6, Offray Vladimir Luna > Cárdenas wrote: > ...
> [The process] seemed more like reading a map and finding where I was and >> then >> finding my way to my intended destination [than] reading the manual. >> That "path" is now with me, next time I need to reach similar places. >> > > Seems like an excellent analogy. Reading docs sucks ;-) > This discussion about documentation has been fruitful. Reinhard's observation that we mostly use docs as references is right on target. Some further thoughts: 1. No matter how good long docs are, it is rare that people will read them even once carefully. After that, we just want answers to specific questions. 2. When is the last time you used an index or table of contents? We use google for *everything* now. Does it really matter how docs are organized? Maybe the very first time... 3. This suggests that we should (no kidding) start paying attention to optimizing google searches on our docs. In short, google is a highly disruptive technology as far as docs are concerned. This is a new thought today. Not sure what to do with it... Your comments, please. Edward -- You received this message because you are subscribed to the Google Groups "leo-editor" group. To unsubscribe from this group and stop receiving emails from it, send an email to leo-editor+unsubscr...@googlegroups.com. To post to this group, send email to leo-editor@googlegroups.com. Visit this group at https://groups.google.com/group/leo-editor. For more options, visit https://groups.google.com/d/optout.
