Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Add Bundler Installation Instructions #6828
This commit addresses issue #6800. Specifically, this commit adds a
In addition, clean up the surrounding instructions a bit, and add some
Thanks @mkasberg, we need to do better on install instructions for different systems.
This feels too custom/advanced for a default install compared to the instructions for installing jekyll on Linux on CloudCannon.
I don't mind adding a dedicated
This does not prevent to also add advanced methods and custom options like the
Our installation section is now so big, we definitely need a table of contents or something of the like. Also I'm not sure whether putting the bundler method first is the right choice here, while it is probably the right-est method, it's not the easiest one and not the one we should recommend.
Thanks for all the comments everyone, it's all good feedback.
I think perhaps this pull request is changing too much too quickly. @oe brings up a good point that while Bundler may be preferable for some users, perhaps it's not a good default if you're going for the simplest method. Also, I don't do
I guess the original thing that I wanted to fix is to make sure a new user knows what to do if they run into permissions problems at the
This has been a very difficult problem for us to solve. On the one hand, we do not distribute or support Ruby or Bundler and aren't really setup to support users that are still trying to get those things installed. On the other hand, this is the biggest hurdle for new users getting started with Jekyll, and I am sure we would have happier users (and quite possibly more developers) if installing Jekyll were not by far the most difficult step toward using (or contributing to) Jekyll.
What makes it especially tricky is that, as on display in this thread, it seems there are as many different ways to install Jekyll as there are users using Jekyll. This means there isn't necessarily anything as simple as "Copy these three lines and paste them into a shell."
You have done a lot of good work here and it would be a shame to just close the PR. I wonder if this could be spun into a tutorial for installing Jekyll on Ubuntu or something similar? Maybe for users that want to use a Docker container or install Jekyll system wide, make sure you have these dependencies and
I could spin this PR off into a tutorial, "Using Jekyll as a Bundler Dependency," that's probably a better place for it. It can be done without the
I'm also willing to help with writing installation instructions for GNU/Linux, I think the idea of separate sections probably makes sense.