Updates to documentation for initial setup

[ghost]

Adds documentation to bypass setup errors.

[e-t-k]

Please also write down the documentation for how to install docker-machine and add to your path variable- this is the starting page https://docs.docker.com/machine/install-machine/#install-machine-directly but it assumes you have sudo ; in our case we want to just install it "personally".

[e-t-k]

Provide instructions for:
a) checking if you already have an "~/.ssh/id_rsa" private+public keypair files that don't require a password
b) if you don't have a keypair, how to create it

[e-t-k]

Another thing to incorporate at the end:

• how to spin down machines when done
• the info from Rob's April 12 email "Floating IPs" about how to clear the IP addresses after spinning down machines.

[e-t-k]

Thank you @aglyle ; I'm satisfied.

@klearned , passing this to you -- could you please do a readthrough of the new treeshop.md for potential improvements?

[klearned]

Yes, I'll read through the new treeshop.md today

[ghost]

Thanks for the comments @klearned!
@e-t-k can you take a final look at these changes and I'll ping Rob to merge the branch.

[e-t-k]

@aglyle looks great. I approve this doc.

[ghost]

@rcurrie Updates to the treeshop.md ready to be merged with master. Let me know if there's anything you want me to change.

[rcurrie]

Good work - thank you for filling in pieces. I made a bunch of comments (feel free to push back!). In general I want to be careful about helping someone use this vs. helping someone that shouldn’t be using this.

…

On May 31, 2018, at 12:35 PM, Geoff Lyle ***@***.***> wrote: @rcurrie <https://github.com/rcurrie> Updates to the treeshop.md ready to be merged with master. Let me know if there's anything you want me to change. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#13 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAeEGjVKXYBzwy1aThYuhOxVnJIVkIVYks5t4EXngaJpZM4TW7PA>.

[rcurrie]

Some specific comments below, but in general suggest this should be very prescriptive step by step so that someone can bring up a single group of machines, process, and shut down all with the HEAD of master.

[rcurrie]

Shouldn't need SRA

[rcurrie]

Suggest we remove all of this. Most people should follow a very rote path: up process down, repeat. At the very end have a section called 'advanced' where you point them to the fabric and docker-machine docs and allude to this but not spell it out. Having subsets of machines running, and the need to reset, is asking for problems for those that don't know how all this really works.

[rcurrie]

Also remove this toward a very prescriptive approach to these docs. The advanced pointer can list capabilities (running multiple fab files, multiple clusters via fab and docker-machine) but not spell it out. Multiple fab files plus multiple clusters to someone not familar with distributed computing. Also if they have an editied fabfile the hash in the methods.json will not be correct and we'll have no way to sort out what happened after the fact.

[ghost]

@rcurrie Incorporated your comments. Removed sections that we expect users to know (SSH Key creation), unsure if you wanted to keep PATH setup or not, but it's removed in the latest version. Also moved documentation for shutting down select machines and different fabfiles to links in the options. Removed shutting down IPs as it is Treehouse specific.