Add Troubleshooting section

[bridgethillyer]

As we encounter issues with environment setup, etc. in workshops, it would be great to have a section of the curriculum that has fixes for problems we've seen before.

Include Issue #75

[bridgethillyer]

Include Issue #78

[k4y3ff]

For anyone interested in taking this issue on: We haven't really discussed where it would be best to put a "Troubleshooting" section.

It might make sense for any problems with environment setup to be added to the individual installation pages for each operating system. You can find links to those pages here, under "Instructions by operating system."

Alternatively, it would also make sense to just make a new page called "Installfest Troubleshooting," or something similar, and clearly mark which problems are for which operating system. Then, link to it from the main "Getting Set Up" page.

[bridgethillyer]

AFAIK, no one is working on this one, so this is a great issue to start on for someone looking for somewhere to get started helping with the curriculum. Even just creating a Troubleshooting section (in either of the ways @kpfell mentions above) and adding the #75 and #78 items would be a great start so others would have a place to start adding other issues they run into.

[ghost]

Hi! Thanks for this very clear and understandable installation guide. I was able to go from zero to installation to creating a my own simple starter app in under an hour. (note: I did have an older install on another machine that I hadn't looked at for months). I think your installation instructions contain better detail compared to other beginner tutorials and docs. My only minor thing is that I could not get LightTable to launch and the LightTable docs are very sparse on the install process so I'm not sure what exactly is the issue. But, it doesn't matter. I just used a basic linux text editor and will probably try with the Clojure plugin for Atom. Perhaps, there could be a section in the docs mentioning other possible editors? I would be happy to help with writing something if you need any additional contributors. Thanks for this nice resource.

[k4y3ff]

Howdy, @nottaanibot!

Hi! Thanks for this very clear and understandable installation guide. I was able to go from zero to installation to creating a my own simple starter app in under an hour. (note: I did have an older install on another machine that I hadn't looked at for months). I think your installation instructions contain better detail compared to other beginner tutorials and docs.

🎉

Super-happy to hear it.

My only minor thing is that I could not get LightTable to launch and the LightTable docs are very sparse on the install process so I'm not sure what exactly is the issue.

😞

Did you get any error messages, or...? I'd be glad to try my hand at troubleshooting and updating the docs.

Perhaps, there could be a section in the docs mentioning other possible editors? I would be happy to help with writing something if you need any additional contributors.

We have a different project, getting-started, which theoretically contains set-up instructions for different editors--though, right now, it only contains instructions for Nightcode.

You're right, though; we should definitely link to that project somewhere in the curriculum docs, because it doesn't seem very visible now! Plus, a lot of people (myself included!) don't use LightTable as their primary editor. We use LightTable for the workshops, though, which is why it's front and center.

I would be happy to help with writing something if you need any additional contributors. Thanks for this nice resource.

Yes, by all means! We'd be super-glad to have additional instructions in the getting-started project, and if you see anything that doesn't work, please do open an issue. 🎉

Cheers!

[ghost]

Hi @kpfell! Great, I will have a look at the getting-started section and read over the curriculum and hopefull provide some more input.

LightTable: I installed it per the curriculum section and opened it from the command line (yay!). But, it gave a weird connection error when trying to input Clojure code in the instarepl. Then, the next day, it wouldn't even launch. I'm going re-install LightTable and if it doesn't work again then I'll open an issue.

Cheers!

[chadhs]

i've had problems with lighttable and the instarepl as well on 10.11.

i'm working on getting prepped for a mini workshop to explore clojure at the Clojure MKE meetup next week and have found setting up Sublime Text 3 + the SublimeREPL plugin to be a very small amount of steps.

@kpfell if interested i could write up a doc and send it your way if you want an alternative for the workshops.

[ghost]

Thanks for bumping this. I think Sublime is a good choice for a workshop.
There are also some Atom plugins that could be possible options that are on
my todo list.

On Wed, Jan 13, 2016 at 3:32 PM, Chad Stovern [email protected]
wrote:

i've had problems with lighttable and the instarepl as well on 10.11.

i'm working on getting prepped for a mini workshop to explore clojure at
the Clojure MKE meetup next week and have found setting up Sublime Text 3 +
the SublimeREPL plugin to be a very small amount of steps.

@kpfell https://github.com/kpfell if interested i could write up a doc
and send it your way if you want an alternative for the workshops.

—
Reply to this email directly or view it on GitHub
#98 (comment)
.

[chadhs]

@nymoorland np. :-)

• lighttable is an excellent choice as there are very few steps for a beginner to setup.
• sublime text has a few more steps involved by works well, i actually completed the install fest app test this morning using it.
• atom is really nice with an excellent gui for settings, but it feels pretty crashy, especially for clojure repl support at this time. :-(