[ARROW-3533] [Python/Documentation] Use sphinx_rtd_theme instead of Bootstrap

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 0.12.0
• Component/s: Documentation, Python
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/19848
• Assignee: Uwe Korn
• Reporter: Uwe Korn
• Created: 16/Oct/18 12:49
• Updated: 11/Jan/23 07:28
• Resolved: 17/Oct/18 13:53

Description

I have got some feedback that the Arrow Python API documentation is a bit confusing as the ToC/Menu is only really visible on the front page. People get confused by the top header. As we are already diverging from the main homepage as this was migrated to a newer bootstrap version anyway, I suggest to change the documentation theme.

As a best practice, I would switch back to the sphinx_rtd_theme as this provides a UX people are used to and happy with. We can customize it if needed later as e.g. dask did: https://github.com/dask/dask-sphinx-theme

Issue Links

• links to: GitHub Pull Request #2776