Please use Jekyll via "bundle exec" from now on

[Attila Zsolt Piros]

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

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 님이
작성:

> 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
>

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

[Jungtaek Lim]

Nice fix. Thanks!

On Thu, Feb 18, 2021 at 7:13 PM Hyukjin Kwon  wrote:

> Thanks Attlila for fixing and sharing this.
>
> 2021년 2월 18일 (목) 오후 6:17, Attila Zsolt Piros 님이
> 작성:
>
>> 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
>>
>

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

[Attila Zsolt Piros]

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 <
piros.attila.zs...@gmail.com> 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
>