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. 
<https://www.google.com/url?q=https%3A%2F%2Fgithub.com%2Fleo-editor%2Fleo-editor%2Fissues%2F356&sa=D&sntz=1&usg=AFQjCNEvgzmDKUYrYodpiwziMgj9QxwxpQ>
> Done: #388: wikiview.py plugin problem with new colorizing code 
<https://www.google.com/url?q=https%3A%2F%2Fgithub.com%2Fleo-editor%2Fleo-editor%2Fissues%2F388&sa=D&sntz=1&usg=AFQjCNHCXReOrhfGeTykOZN0934LnxIdsQ>
> Done: #372: Support something like emacs electric url's 
<https://www.google.com/url?q=https%3A%2F%2Fgithub.com%2Fleo-editor%2Fleo-editor%2Fissues%2F372&sa=D&sntz=1&usg=AFQjCNEgL8WRUDAp0mLDw8RFzCyiGnNdGw>
> Deferred: #396: Show images in Leo's body pane 
<https://github.com/leo-editor/leo-editor/issues/396>

I expect to spend *at least* a week revising tutorials and creating 
presentations with the new demo.py plugin. In fact, I don't want to set 
myself any deadline at all for 5.5b1, because...

While working on the demo docs 
<https://github.com/leo-editor/leo-editor/blob/master/leo/doc/demo.md>, I 
am getting the vague stirrings that there is a breakthrough in 
communication lurking nearby. Part of it is the "less said the better" 
principle. But there is something else, too.

The feeling is that good docs may be akin to small chunks of code. 
Certainly, we want to intermix words and code. More importantly, the 
essence of Leo is a *process.*

This may be what newbies are *really *wanting when they say they want 
step-by-step *instructions*. In fact, they want to *see* Leo *in action*, 
in step-by-step increments.

For the first time, the demo.py plugin gives us all the chance to play with 
these notions. The fuzzy picture I have is of dozens, hundreds or even 
thousands of tiny *nuggets of experiece* to be imparted to newbies.  
Naturally, we want to get people going quickly, after only a few dozen :-) 
But getting there may require a many more. Deadlines are not my friend just 
now.

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 [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/leo-editor.
For more options, visit https://groups.google.com/d/optout.

Reply via email to