search

floydhub / floyd-docs

FloydHub's documentation code. Contributions welcome!
https://docs.floydhub.com/
63 stars 67 forks source link

Update the quickstart #85

Closed mckayward closed 6 years ago

mckayward commented 6 years ago

Proposed update to the quickstart tutorial.

This was kind of sitting stale for a bit, so I think feedback would be good. It's a fair amount longer than the old quickstart, so maybe we can get rid of some stuff if it's too tedious to get through. I am open to any feedback.

I ran through the quick-start from start to finish with the new code and descriptions and everything seems to be in line, but let me know if you see any issues.

Being served here

saiprashanths commented 6 years ago

Starting to review the article. But, at first glance, this is no longer "quick" :) It's a pretty comprehensive run through, and there's a lot of value to it.

Can we distill down the commands (or subset of commands) from this and create an actual quick start? Example: Hy Quickstart. We can either put this on the top of this article or create a separate quick start tutorial and call this a more comprehensive tutorial?

mckayward commented 6 years ago

Yeah I agree with you. I'll cut some stuff out

On Sep 27, 2017 at 4:36 PM, wrote:

Starting to review the article. But, at first glance, this is no longer "quick" :) It's a pretty comprehensive run through, and there's a lot of value to it.

Can we distill down the commands (or subset of commands) from this and create an actual quick start? Example: Hy Quickstart. We can either put this on the top of this article or create a separate quick start tutorial and call this a more comprehensive tutorial?

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub, or mute the thread.

saiprashanths commented 6 years ago

Read through it. Looks great - solid intro tutorial!

saiprashanths commented 6 years ago

Yeah I agree with you. I'll cut some stuff out

After reading through it, I really like it. I don't think we have to cut anything out of this. It might just be worthwhile to have a true quickstart for the impatient reader, in addition to this more comprehensive walkthrough

mckayward commented 6 years ago

Okay I made the merge-necessary changes. Per our conversation outside this PR, I am merging now and we will iterate later with a shorter quickstart, and then put this into its own tutorial