Re: GSoD - Technical Writter

On Sat, May 18, 2019 at 04:40:50PM +0200, Ralf Gommers wrote:
> You're right, the interface is a little outdated. Docs will have to stay in
> Sphinx (that's really the only choice for reST docs for a large Python
> package), however the top level websites (scipy.org, docs.scipy.org) could be
> moved to Jekyll or Hugo for a more modern look - this will actually be
> beneficial.

Sphinx uses standard web tools as outputs (the jinja templating engine,
for instance). This problem, to me, is a theming problem: templating +
CSS. In scipy-lectures, I had done some work to build a theme that is
mobile friendly. More generally, I think that there would be value in
maintaining these themes in a way that can be shared across project.
Sphinx does have modern themes, such as
https://alabaster.readthedocs.io/en/latest/


> Yes, there's https://scipy-lectures.org/ for example. Guiding users effectively
> to all existing resources will be a major step forward.

Glad to see some synergy here!

Cheers,

Gaël