Re: Org Mode: Learning on demand
On Thu, Feb 16, 2017 at 6:30 PM, Offray Vladimir Luna Cárdenas < off...@riseup.net> wrote: >> I think the guideline should be: if you want it, you should give it a try. I truly would appreciate help with docs, or any other project. > I can imagine myself helping with writing interactive documentation to introduce newbies to Leo (as I did with my students years ago) and with co-designing the Leo's future with the community meanwhile. That would be great. Thanks. 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.
Re: Org Mode: Learning on demand
Hi, On 16/02/17 18:09, Edward K. Ream wrote: On Thu, Feb 16, 2017 at 4:10 PM, Offray Vladimir Luna Cárdenas mailto:off...@riseup.net>> wrote: I would like Leo interactive documentation to be as easy to browse as Org's and to point to the external world (and of course search and privacy friendly). Worthy goals. I'm not sure when it will happen, given all the other tempting things on hand at present. I think the guideline should be: if you want it, you should give it a try. I truly would appreciate help with docs, or any other project. I will try to help, once interactive documentation is enabled (Org, Pyzo or other way alike). ATM outline interactive documentation is too engaging to leave it for non-interactive one. But I can imagine myself helping with writing interactive documentation to introduce newbies to Leo (as I did with my students years ago) and with co-designing the Leo's future with the community meanwhile. Cheers, Offray -- 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.
Re: Org Mode: Learning on demand
On Thu, Feb 16, 2017 at 4:10 PM, Offray Vladimir Luna Cárdenas < off...@riseup.net> wrote: I would like Leo interactive documentation to be as easy to browse as Org's > and to point to the external world (and of course search and privacy > friendly). > Worthy goals. I'm not sure when it will happen, given all the other tempting things on hand at present. I think the guideline should be: if you want it, you should give it a try. I truly would appreciate help with docs, or any other project. 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.
Re: Org Mode: Learning on demand
Hi, On 16/02/17 16:54, Edward K. Ream wrote: 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. Agreed. 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... Yesterday was the last time I used index (the interactive one of Org Mode documentation) and all the process I described about looking for videos, watching them and finding my way into a memorable task was made without Google (the search related parts were done with DuckDuckGo, and the videos were wrapped in the DDG viewer instead of SPAMware YouTube). I think that we need to be searchable, browsable and readable from the web, but hopefully in a world were search and google (and Big Brother!) are not synonyms. I would like Leo interactive documentation to be as easy to browse as Org's and to point to the external world (and of course search and privacy friendly). Cheers, Offray -- 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.
Re: Org Mode: Learning on demand
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.
Re: Org Mode: Learning on demand
On Thursday, February 16, 2017 at 10:47:01 AM UTC-6, Offray Vladimir Luna Cárdenas wrote: Recently I need to create a table in plain text and I new that Org-Mode > has a easy and intuitive way to do it, but I *didn't* want to learn > emacs to use Org-Mode. So I went to the Org-Mode screencasts web page > and saw the first 10 minutos or so of 2011 - Org Demo by Bastien [1]. I > particularly liked the idea of "not learning curve" and the idea of not > needing to learn Emacs to learn Org-Mode (that was my case). Then I saw > and introductory video "Taking Notes In Emacs Org-Mode" [2] which > provided example about outlining, taking notes, GTD and at the end, how > to reach org-mode documentation. Then I open the documentation, went to > tables, read a little while seeing the "panoramic" video on tables in > Org Mode at [3]. After that, and a couple of minutes, I was able to make > tables in Org-Mode plain text markup and this changed my way of doing > plain text tables forever... > [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 ;-) 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.
