<div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, May 18, 2019 at 4:52 PM Gael Varoquaux <<a href="mailto:gael.varoquaux@normalesup.org">gael.varoquaux@normalesup.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Sat, May 18, 2019 at 04:40:50PM +0200, Ralf Gommers wrote:<br>
> You're right, the interface is a little outdated. Docs will have to stay in<br>
> Sphinx (that's really the only choice for reST docs for a large Python<br>
> package), however the top level websites (<a href="http://scipy.org" rel="noreferrer" target="_blank">scipy.org</a>, <a href="http://docs.scipy.org" rel="noreferrer" target="_blank">docs.scipy.org</a>) could be<br>
> moved to Jekyll or Hugo for a more modern look - this will actually be<br>
> beneficial.<br>
<br>
Sphinx uses standard web tools as outputs (the jinja templating engine,<br>
for instance). This problem, to me, is a theming problem: templating +<br>
CSS. In scipy-lectures, I had done some work to build a theme that is<br>
mobile friendly. More generally, I think that there would be value in<br>
maintaining these themes in a way that can be shared across project.<br>
Sphinx does have modern themes, such as<br>
<a href="https://alabaster.readthedocs.io/en/latest/" rel="noreferrer" target="_blank">https://alabaster.readthedocs.io/en/latest/</a></blockquote><div><br></div><div>Hey Gael, I think you're mostly right that it's about theming, but not completely. Alabaster isn't really the kind of theme that helps. It's still for docs. For a modern website, Sphinx is just not a great tool. I'd love something like <a href="https://jupyter.org/">https://jupyter.org/</a> or <a href="https://julialang.org/">https://julialang.org/</a>, and then a Sphinx site under it for user and reference guides. I don't think Sphinx is the right tool for the job of building a modern top-level site.<br></div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br>
<br>
<br>
> Yes, there's <a href="https://scipy-lectures.org/" rel="noreferrer" target="_blank">https://scipy-lectures.org/</a> for example. Guiding users effectively<br>
> to all existing resources will be a major step forward.<br>
<br>
Glad to see some synergy here!<br></blockquote><div><br></div><div>Perhaps there should be even more synergy. Scipy-lectures and <a href="http://scipy.github.io/devdocs/tutorial/index.html">http://scipy.github.io/devdocs/tutorial/index.html</a> partly overlap in content and scope, separating them better could help users and get us more good-quality material with less effort. I just don't know what the split should be. Any thoughts?</div><div><br></div><div>Cheers,<br></div><div>Ralf</div><div><br></div></div></div></div></div></div>