Skip to content

Conversation

@JoshRosen
Copy link
Contributor

If a custom Jekyll template tag throws Ruby's equivalent of a "file not found" exception, then Jekyll will stop the doc building process but will exit with a successful status, causing our doc publishing jobs to silently fail.

This is caused by jekyll/jekyll#5104, a case of bad error-handling logic in Jekyll. This patch works around this by updating our include_example.rb plugin to catch the exception and exit rather than allowing it to bubble up and be ignored by Jekyll.

I tested this manually with

rm ./examples/src/main/scala/org/apache/spark/examples/sql/SparkSQLExample.scala
cd docs
SKIP_API=1 jekyll build
echo $?

@SparkQA
Copy link

SparkQA commented Jul 14, 2016

Test build #62353 has finished for PR 14209 at commit cd89a2c.

  • This patch passes all tests.
  • This patch merges cleanly.
  • This patch adds no public classes.

@rxin
Copy link
Contributor

rxin commented Jul 14, 2016

Merging in master/2.0.

asfgit pushed a commit that referenced this pull request Jul 14, 2016
…nt failures

If a custom Jekyll template tag throws Ruby's equivalent of a "file not found" exception, then Jekyll will stop the doc building process but will exit with a successful status, causing our doc publishing jobs to silently fail.

This is caused by jekyll/jekyll#5104, a case of bad error-handling logic in Jekyll. This patch works around this by updating our `include_example.rb` plugin to catch the exception and exit rather than allowing it to bubble up and be ignored by Jekyll.

I tested this manually with

```
rm ./examples/src/main/scala/org/apache/spark/examples/sql/SparkSQLExample.scala
cd docs
SKIP_API=1 jekyll build
echo $?
```

Author: Josh Rosen <[email protected]>

Closes #14209 from JoshRosen/fix-doc-building.

(cherry picked from commit 972673a)
Signed-off-by: Reynold Xin <[email protected]>
@asfgit asfgit closed this in 972673a Jul 14, 2016
@JoshRosen JoshRosen deleted the fix-doc-building branch July 14, 2016 23:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants