Hi All,
Here is the first draft of a revised Installation Guide. Writing it was 
quite revealing. Edward, you are right in saying that neither Leo's 
download or install pages clearly present the pros and cons of installing 
via Anaconda, pip, git, setup.py, etc.
Initially I tried to present these choices succinctly. It's not worth the 
trouble; there are always exceptions, catches and exclusions. It would be a 
long, tedious discussion and a new users head would be spinning. The PyQt 
issues caused some difficulty.

I have come to the conclusion that guiding users towards using *pip* is the 
best method. The main reasons being that it installs PyQt5 plus other 
dependencies easily and it interacts well with Git.

I also came to the view that it's not a good idea to recommend Miniconda as 
a solution for new users installing Leo. There is no direct easy install 
path as *conda install leo* currently doesn't work. Using pip achieves the 
same results for all required packages.
I understand this is a matter of preference. Ditto for Anaconda.

In summary, the Install Guide says:
1. Install Python
2. Install Leo with pip
3. Use Git and/or Miniconda if you prefer

Some final comments. I agree fully with your view that we want to minimize 
the words that need to be read before a prospective user can use Leo. I 
feel there we can have less focus on 'Downloading Leo' and more focus on 
'Installing & Running Leo'.
Let the discussion commence!

Here are 2 pre-reading discussions:
1. List of all *python* dependencies and why 
<https://groups.google.com/forum/?fromgroups#!topic/leo-editor/VJHy0XK2NRY>
2. how should an (ordinary) user install Leo on Linux? 
<https://groups.google.com/forum/?fromgroups#!searchin/leo-editor/miniconda/leo-editor/jdPRUOcRkkk/qqHdqgc9BQAJ>

Regards
Lewis

On Wednesday, November 29, 2017 at 2:01:49 AM UTC+11, Edward K. Ream wrote:
>
> ​True, but we want to minimize the words that need to be read before a 
> prospective user can use Leo.
>
> Lewis, you've helped greatly with Leo's docs in the past. I'm hoping you 
> will help with these newbie docs.
>
> 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