Repository navigation
Add Troubleshooting section #98
Description
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
Activity
bridgethillyer commentedon Jul 15, 2014
Include Issue #78
k4y3ff commentedon Feb 7, 2015
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 commentedon Feb 8, 2015
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.
k4y3ff commentedon Mar 5, 2015
Howdy, @nottaanibot!
🎉
Super-happy to hear it.
😞
Did you get any error messages, or...? I'd be glad to try my hand at troubleshooting and updating the docs.
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.
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!
chadhs commentedon Jan 13, 2016
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.
chadhs commentedon Jan 19, 2016
@nymoorland np. :-)