search

ClojureBridge / curriculum

Curriculum for the ClojureBridge workshop series.
https://clojurebridge.github.io/curriculum/
482 stars 199 forks source link

Add Troubleshooting section #98

Open bridgethillyer opened 10 years ago

bridgethillyer commented 10 years ago

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 commented 10 years ago

Include Issue #78

k4y3ff commented 9 years ago

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 commented 9 years ago

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 commented 9 years ago

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 commented 9 years ago

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.

:tada:

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.

:disappointed:

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. :tada:

Cheers!

ghost commented 9 years ago

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 commented 8 years ago

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 commented 8 years ago

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 notifications@github.com 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 https://github.com/ClojureBridge/curriculum/issues/98#issuecomment-171441190 .

chadhs commented 8 years ago

@nymoorland np. :-)