Re: Turning to documentation

2017-04-03 Thread Edward K. Ream
On Sun, Apr 2, 2017 at 8:23 PM, Joe Orr wrote: > > Also, as part of Leo Viewer I made a couple of very simple intro tutorials > here: https://github.com/kaleguy/leo-tutorials > > I'll probably add more or maybe I should be trying to use the existing > ones. Any thoughts on

Re: Turning to documentation

2017-04-02 Thread 'Terry Brown' via leo-editor
On Sun, 2 Apr 2017 18:23:07 -0700 (PDT) Joe Orr wrote: > Not sure I'm following this discussion completely, maybe I should > post a new thread... > > Anyway, I'm planning on adding presentations to Leo Viewer at some > point using this: https://github.com/hakimel/reveal.js/

Re: Turning to documentation

2017-04-02 Thread Joe Orr
Not sure I'm following this discussion completely, maybe I should post a new thread... Anyway, I'm planning on adding presentations to Leo Viewer at some point using this: https://github.com/hakimel/reveal.js/ Also, as part of Leo Viewer I made a couple of very simple intro tutorials here:

Re: Turning to documentation

2017-03-20 Thread Offray Vladimir Luna Cárdenas
And maybe from docs as mini programs to live docs as live mini-programs ;-)... interesting times are coming from Leo and literate computing and maybe another important breakthrough in the 20+ Leo's history. Cheers, Offray On 09/02/17 11:55, Edward K. Ream wrote: ​​ On Thu, Feb 9, 2017 at

Re: Turning to documentation

2017-02-11 Thread Edward K. Ream
On Friday, February 10, 2017 at 9:28:39 AM UTC-6, Edward K. Ream wrote: I want to emphasize something. Demo scripts can use *all *parts of Leo's > API to "run" Leo automatically. For example, this is one way to create a > new node: > > p = c.insertHeadline() > p.h = 'a headline' > p.b = 'some

Re: Turning to documentation

2017-02-10 Thread Edward K. Ream
On Fri, Feb 10, 2017 at 9:37 AM, lewis wrote: Just thinking out aloud here as I read about your writing *before* your > Aha. Is it possible to integrate the concept of chapters as you write your > executable documents and are 'Composing script lists from a tree of

Re: Turning to documentation

2017-02-10 Thread Edward K. Ream
On Fri, Feb 10, 2017 at 9:28 AM, Edward K. Ream wrote: ​> ​ Instant automation! Do you see how cool this is? ​Although usually simple, ​the various setup/teardown methods help devs maintain momentum and energy. ​ This is important, especially when confronting a long period

Re: Turning to documentation

2017-02-10 Thread Edward K. Ream
​​ ​​ On Fri, Feb 10, 2017 at 4:22 AM, Geoff Evans wrote: ​ ​ ​> ​ A good test is both (a) an illustration of something the program should do; (b) an ability to detect if the program isn't doing it. In this light, tests appear as helpers toward understanding rather than

Re: Turning to documentation

2017-02-10 Thread lewis
Just thinking out aloud here as I read about your writing *before* your Aha. Is it possible to integrate the concept of chapters as you write your executable documents and are 'Composing script lists from a tree of nodes'? The idea appeals to me and it also possibly reveals how little I know

Re: Turning to documentation

2017-02-10 Thread Edward K. Ream
​​On Fri, Feb 10, 2017 at 7:18 AM, Edward K. Ream wrote: ​This post will be pre-writing for a new section in ​demo.md . ​> ​ My task is now clear. Create demos that* show Leo in action*!​ This really

Re: Turning to documentation

2017-02-10 Thread Geoff Evans
This encouraging development prompts me to throw something into the mix that's been on my mind for a while. 1. It starts with Edward's Stupendous Aha about tests from months ago, which goes roughly: A good test is both (a) an illustration of something the program should do; (b) an

Re: Turning to documentation

2017-02-09 Thread Edward K. Ream
​​ On Thu, Feb 9, 2017 at 8:55 AM, Edward K. Ream wrote: ​> ​ The feeling is that good docs may be akin to small chunks of code ​. I've spent the last hour or so working on my first "real" demo. As expected, this has suggested a few tweaks to the code, on master. But a

Re: Turning to documentation

2017-02-09 Thread Edward K. Ream
On Friday, February 3, 2017 at 6:35:48 AM UTC-6, Edward K. Ream wrote: > There have been a number of excellent suggestions for Leo's documentation: > Next: #356 Scripting documentation for new users of leoeditor.

Re: Turning to documentation

2017-02-03 Thread Edward K. Ream
On Friday, February 3, 2017 at 6:35:48 AM UTC-6, Edward K. Ream wrote: > I have just added these items to the 5.5b1 list: And another: #397: Emulate (and improve on) pyzo's "wizard" handling Edward -- You received this message because you

Turning to documentation

2017-02-03 Thread Edward K. Ream
There have been a number of excellent suggestions for Leo's documentation recent, especially #356 Scripting documentation for new users of leoeditor. To support tutorials, I have just added these items to the 5.5b1 list: #388: wikiview.py