Please use Jekyll via "bundle exec" from now on

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

Please use Jekyll via "bundle exec" from now on

attilapiros
Hello everybody,

To pin the exact same version of Jekyll across all the contributors, Ruby Bundler is introduced.
This way the differences in the generated documentation, which were caused by using different Jekyll versions, are avoided.

Regarding its usage this simply means an extra prefix "bundle exec" must be added to call Jekyll, so:
- instead of "jekyll build" please use "bundle exec jekyll build"
- instead of "jekyll serve --watch" please use "bundle exec jekyll serve --watch"

If you are using an earlier Ruby version please install Bundler by "gem install bundler" (as of Ruby 2.6 Bundler is part of core Ruby).

This applies to both "apache/spark" and "apache/spark-website" repositories where all the documentations are updated accordingly.

For details please check the PRs introducing this:
- https://github.com/apache/spark/pull/31559
- https://github.com/apache/spark-website/pull/303

Sincerely,
Attila Piros
Reply | Threaded
Open this post in threaded view
|

Re: Please use Jekyll via "bundle exec" from now on

Hyukjin Kwon
Thanks Attlila for fixing and sharing this.

2021년 2월 18일 (목) 오후 6:17, Attila Zsolt Piros <[hidden email]>님이 작성:
Hello everybody,

To pin the exact same version of Jekyll across all the contributors, Ruby Bundler is introduced.
This way the differences in the generated documentation, which were caused by using different Jekyll versions, are avoided.

Regarding its usage this simply means an extra prefix "bundle exec" must be added to call Jekyll, so:
- instead of "jekyll build" please use "bundle exec jekyll build"
- instead of "jekyll serve --watch" please use "bundle exec jekyll serve --watch"

If you are using an earlier Ruby version please install Bundler by "gem install bundler" (as of Ruby 2.6 Bundler is part of core Ruby).

This applies to both "apache/spark" and "apache/spark-website" repositories where all the documentations are updated accordingly.

For details please check the PRs introducing this:
- https://github.com/apache/spark/pull/31559
- https://github.com/apache/spark-website/pull/303

Sincerely,
Attila Piros
Reply | Threaded
Open this post in threaded view
|

Re: Please use Jekyll via "bundle exec" from now on

Jungtaek Lim-2
Nice fix. Thanks!

On Thu, Feb 18, 2021 at 7:13 PM Hyukjin Kwon <[hidden email]> wrote:
Thanks Attlila for fixing and sharing this.

2021년 2월 18일 (목) 오후 6:17, Attila Zsolt Piros <[hidden email]>님이 작성:
Hello everybody,

To pin the exact same version of Jekyll across all the contributors, Ruby Bundler is introduced.
This way the differences in the generated documentation, which were caused by using different Jekyll versions, are avoided.

Regarding its usage this simply means an extra prefix "bundle exec" must be added to call Jekyll, so:
- instead of "jekyll build" please use "bundle exec jekyll build"
- instead of "jekyll serve --watch" please use "bundle exec jekyll serve --watch"

If you are using an earlier Ruby version please install Bundler by "gem install bundler" (as of Ruby 2.6 Bundler is part of core Ruby).

This applies to both "apache/spark" and "apache/spark-website" repositories where all the documentations are updated accordingly.

For details please check the PRs introducing this:
- https://github.com/apache/spark/pull/31559
- https://github.com/apache/spark-website/pull/303

Sincerely,
Attila Piros
Reply | Threaded
Open this post in threaded view
|

Re: Please use Jekyll via "bundle exec" from now on

attilapiros
In reply to this post by attilapiros

With this commit a github workflow introduced for the PRs of the spark-website repo.

It contains an action to check:
  • whether the generation was complete (it contains all the generated HTMLs for the last versions of the markdown files)
  • whether the right version of Jekyll was used

On Thu, Feb 18, 2021 at 10:17 AM Attila Zsolt Piros <[hidden email]> wrote:
Hello everybody,

To pin the exact same version of Jekyll across all the contributors, Ruby Bundler is introduced.
This way the differences in the generated documentation, which were caused by using different Jekyll versions, are avoided.

Regarding its usage this simply means an extra prefix "bundle exec" must be added to call Jekyll, so:
- instead of "jekyll build" please use "bundle exec jekyll build"
- instead of "jekyll serve --watch" please use "bundle exec jekyll serve --watch"

If you are using an earlier Ruby version please install Bundler by "gem install bundler" (as of Ruby 2.6 Bundler is part of core Ruby).

This applies to both "apache/spark" and "apache/spark-website" repositories where all the documentations are updated accordingly.

For details please check the PRs introducing this:
- https://github.com/apache/spark/pull/31559
- https://github.com/apache/spark-website/pull/303

Sincerely,
Attila Piros