[jira] [Created] (ZEPPELIN-813) Update docs site dependencies

["Cheng-Yu Hsu (JIRA)" <ji...@apache.org>]

Cheng-Yu Hsu created ZEPPELIN-813:
-------------------------------------

             Summary: Update docs site dependencies
                 Key: ZEPPELIN-813
                 URL: https://issues.apache.org/jira/browse/ZEPPELIN-813
             Project: Zeppelin
          Issue Type: Improvement
          Components: documentation
    Affects Versions: 0.5.6, 0.5.5, 0.5.0, 0.6.0
         Environment: Ruby 2.3.0p0 on Mac OS X 10.11.4
            Reporter: Cheng-Yu Hsu
            Priority: Minor
             Fix For: 0.6.0


Hi,

I encountered some problems when trying to start the server for the docs (under `./docs`).

```
$ bundle exec jekyll serve --watch
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/user_interaction.rb:328: warning: constant ::TimeoutError is deprecated
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/runner.rb:365:in `block in require_program': program version required (Commander::Runner::CommandError)
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/runner.rb:364:in `each'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/runner.rb:364:in `require_program'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/runner.rb:52:in `run!'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/delegates.rb:7:in `run!'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/commander-4.1.5/lib/commander/import.rb:10:in `block in <top (required)>'
/Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/safe_yaml-0.9.7/lib/safe_yaml/syck_node_monkeypatch.rb:42:in `<top (required)>': uninitialized constant Syck (NameError)
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/safe_yaml-0.9.7/lib/safe_yaml.rb:200:in `require'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/safe_yaml-0.9.7/lib/safe_yaml.rb:200:in `<module:YAML>'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/safe_yaml-0.9.7/lib/safe_yaml.rb:132:in `<top (required)>'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/jekyll-1.3.0/lib/jekyll.rb:21:in `require'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/jekyll-1.3.0/lib/jekyll.rb:21:in `<top (required)>'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/jekyll-1.3.0/bin/jekyll:7:in `require'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/lib/ruby/gems/2.3.0/gems/jekyll-1.3.0/bin/jekyll:7:in `<top (required)>'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/bin/jekyll:23:in `load'
	from /Users/cyhsutw/.rbenv/versions/2.3.0/bin/jekyll:23:in `<main>'
```

After analyizing the error, I found the issue was related to `safe_yaml` gem (`uninitialized constant Syck (NameError)`).

According to the [documentation of Ruby `stdlib`](http://ruby-doc.org/stdlib-2.2.2/libdoc/yaml/rdoc/YAML.html#module-YAML-label-History), `Syck` is deprecated in `1.9.0` and is removed in `2.0.0`.

The maintainers of `safe_yaml` have [fixed](https://github.com/dtao/safe_yaml/commit/26c235da7ad0529fe3aaa5a023503138cf8cf7c9) this and it's backward compatible with older Ruby using `Syck`.

One solution to this issue is updating the `safe_yaml` gem.

Another solution is updating the `github-pages` gem to the latest version `69`, which requires the `safe_yaml` gem to have version `1.0.4`.


Personally, I'd like to have the dependencies up-to-date if there's no compatibility issues.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)