[MXNET-960] Upgrade Sphinx to get required features

• Type: Story
• Status: To Do
• Priority: Major
• Resolution: Unresolved
• Component/s: CI Build
• Labels: documentation
• Epic Link: Documentation pipeline
• Assignee: Aaron Markham
• Reporter: Aaron Markham
• Created: 18/Sep/18 01:22
• Updated: 04/Dec/18 17:10

Description

Sphinx is currently at v1.5.6. Certain features available in 1.6.x are desired. There is also v2.0.0 to consider.

Update required (>v1.6.4) for fixes related to logging/warnings: https://github.com/sphinx-doc/sphinx/issues/3926

Another option is to switch to Jekyll, however we'll still want something to build the API docs for Python. So we might need an upgrade anyway.

Sub-Tasks

• Replace recommonmark: To Do
• Test m2r: In Progress