I might just be missing an installation step for css. Here's the traceback:

The headings applied in the demo do not correspond to headings they claim to be.

<div class="section" id="Headings">
<h2>Headings<a class="headerlink" href="#Headings" title="Permalink to this headline">¶</a></h2>
<p>This is a first level heading (<code class="docutils literal"><span class="pre">h1</span></code>).</p>
<div class="section" id="Sub-Heading">
<h3>Sub-Heading<a class="headerlink" href="#Sub-Heading" title="Permalink to this headline">¶</a></h3>
<p>This is a second level heading (<code class="docutils literal"><span class="pre">h2</span></code>).</p>
<div class="section" id="Sub-Sub-Heading">
<h4>Sub-Sub-Heading<a class="headerlink" href="#Sub-Sub-Heading" title="Permalink to this headline">¶</a></h4>
<p>This is a third level heading (<code class="docutils literal"><span class="pre">h3</span></code>).</p>
</div>

There is no LICENSE, LICENSE.md, LICENSE.rst, or LICENSE.txt. There is a BOOTSTRAP_THEME_LICENSE.txt, but it's not really clear to what this applies, since the name implies that it's only some smaller part of the repo.

setup.py states MIT, so it would be good to include a license file that says so.

They won't be published to PyPI without it.

(Opening this to keep track of the discussions on the subject.) Here is an opinionated take on the matter:

I think that we should not have a custom sphinx theme on RTD.

• The RTD team does a great job with their them that works on a large variety of browsers and mobile devices.
• They dedicate more bandwidth to this problem than the jupyter team will ever do. If one of us wants to work on this subject, it might be better to help them than trying to do our own thing.
• IMO, having a uniform style on all RTD-hosted docs is a nice feature of their web site and we would be better citizens if we adopted the main theme.
• The only case where we would need to customize things is when we need to add custom javascript such as inline widget rendering, but in this case I would be in favor of using their theme and only adding static resources for the inline widget renderer.

Now, for the Jupyter website, if we were to host our own version of the docs, we could do our own theme. But even then, the best solution is likely to use the most advanced theme out there that is the one of RTD plus some color changes.

Is there a readthedocs page that (at least) demo the theme ? Or a GitHub Pages Page ?
Should we (at least) grab the name ?

Should we rename the repo to jupyter-sphinx-theme for consistency ?