Asciidoctor :: Discussion

Re: Gem paths craziness on cygwin

Posted by mojavelinux on
URL: https://discuss.asciidoctor.org/Gem-paths-craziness-on-cygwin-tp3425p3430.html

On Tue, Jun 23, 2015 at 6:23 PM, wolandscat [via Asciidoctor :: Discussion] <[hidden email]> wrote:

So the environment seems healthier. It might be worth adding a few helpful tips somewhere in the install documentation to say either to set GEM_HOME or else to include ~/bin in the PATH, since most newcomers won't know to do the first, and if they don't do it, and also don't have ~/bin in the path (also very common), nothing's going to work.

What I think we really need is a one page guide to "ensuring you have a sane Ruby environment and you understand it". That way, all Ruby-based Asciidoctor projects can point to this guide to give the background necessary to ensure success following the other instructions...and we don't have to maintain it in more than one place. Based on what I've read from feedback, this is clearly needed.

I did put something similar together for OSX, but I think we need something that covers more environments. (See http://asciidoctor.org/docs/install-asciidoctor-macosx/).

Cheers,

-Dan

Dan Allen | http://google.com/profiles/dan.j.allen