Re: Please review Leo's new 10-minute intro

2017-02-15 Thread lewis
After clicking 'Learn about Leo in 10 minutes' the first thing I read are quotes about Leo. This is a distraction and quite *annoying clutter.* Also I think you can delete "Leo is a full-featured outliner. Unique features make Leo a powerful IDE, Personal Information Manager and scripting

Re: Please review Leo's new 10-minute intro

2017-02-15 Thread Viktor Ransmayr
Hello Edward, For me a very important thing in the 10 minutes intro would be: a) that the SW reflects the environment a 'newbie' finds (i.e. not your individual Leo setup ) & b) that it is up to date (i.e. does not reflect Leo 4.10 ...) HTH. With kind regards, VR -- You received this

Re: Please review Leo's new 10-minute intro

2017-02-15 Thread rengel
> All questions and comments are welcome. > I hope so. Let me play the Devil's Advocate. On the first page of the new tutorial, we find (highlights by me): Leo is a full-featured outliner. Unique features make Leo a powerful IDE, > Personal Information Manager and scripting environment. *The

Re: Leo's HOME directory

2017-02-15 Thread john lunzer
I was afraid of that. Thanks for the thorough response. I was trying to cut some corners to just get a feel for things, but I think much more thought will have to go into this. On Wednesday, February 15, 2017 at 10:40:59 AM UTC-5, Terry Brown wrote: > > I think as a general rule with

Re: Please review Leo's new 10-minute intro

2017-02-15 Thread john lunzer
I think a new Leo main screenshot is in order. When I new user opens Leo for the first time, says to themselves, "I have no idea where to go from here. I had better read the docs", and then actually goes to the docs they should be reassured that the docs are relevant to what they're seeing in

Re: Leo's HOME directory

2017-02-15 Thread 'Terry Brown' via leo-editor
I think as a general rule with os.chdir()/os.getcwd() in Python apps. you can't assume its value, it's a single piece of state shared across the entire app. and all libraries, so really the best thing to do is not use it or rely on it. Your result is not surprising, Leo is setting it between

Please review Leo's new 10-minute intro

2017-02-15 Thread Edward K. Ream
I've just finished a preliminary version of The basics of Leo , advertised on the Tutorials toc page as "Leo in 10 minutes: Leo's most important features". This is the best summary of Leo ever, by far. The "less

Re: Rule #1 for documentation

2017-02-15 Thread Offray Vladimir Luna Cárdenas
Thanks Reinhard for your remarks. Timing with the Leo project and community has been pretty curious. Now I'm writing a "paper" for JOSS (Journal of Open Source Software [1]) and that implies improving the user documentation. So Reinhard remarks and the rewriting Leo doc are pretty timely.

Re: Leo's HOME directory

2017-02-15 Thread john lunzer
I'll use this thread because it seems relevant. I'm trying to do some experiments using Leo as a shell. Amongst other things I'm trying to change this current working directory. I have a small node script: @language python import os os.chdir("..") g.es(os.getcwd(), color="green") Perhaps

Re: Rule #1 for documentation

2017-02-15 Thread Edward K. Ream
On Wed, Feb 15, 2017 at 1:47 AM, rengel wrote: > > So *for documentation*, it might be better to restrain one's links to the > own website. > ​That's the idea. Edward -- You received this message because you are subscribed to the Google Groups "leo-editor"

Re: Rule #1 for documentation

2017-02-15 Thread Edward K. Ream
On Tuesday, February 14, 2017 at 1:19:46 PM UTC-6, Edward K. Ream wrote: > > Here is my new *cardinal rule of documentation*: > > *Thou shalt not put thine audience to sleep* > Leo's web site now contains several revised pages: - Leo's home page now says, "Learn about