You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@arrow.apache.org by "Uwe L. Korn (JIRA)" <ji...@apache.org> on 2018/10/16 12:50:00 UTC

[jira] [Created] (ARROW-3533) [Python/Documentation] Use sphinx_rtd_theme instead of Bootstrap

Uwe L. Korn created ARROW-3533:
----------------------------------

             Summary: [Python/Documentation] Use sphinx_rtd_theme instead of Bootstrap
                 Key: ARROW-3533
                 URL: https://issues.apache.org/jira/browse/ARROW-3533
             Project: Apache Arrow
          Issue Type: Improvement
          Components: Documentation, Python
            Reporter: Uwe L. Korn


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



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)