[Qgis-community-team] QGIS docs: Vanilla build & ReadTheDocs theme

[Richard Duivenvoorde]

On 2019-03-18 09:13, Alexandre Neto wrote:
> Hi, I would refrain to change the looks of it right away.
> I also have my list of improvements for that, but I think it would be
> better to stabilize the usage of the theme and it's options first, and
> then do the improvements on top of that.

+1

> Besides, you probably know that already, but there's a way to separate
> our theme tweaks from the original read the docs theme. We really need
> to do it the right way so we can update the theme whenever we need.
> 
> Related subject: we talked about splitting the QGIS docs content. Will
> we keep using sphinx for the static content?
> 
> If so, and assuming we are going to use the same theme, it would be
> better to share it via submodele, otherwise, any theme tweak must be
> replicated twice.

Yes, but (to me) one reason to split was because I thought to make the 
python cookbook testable it would be better.
I'm still ok to split (in QGIS version specific and non version specific 
docs), but the immidiate need to me is over now (as we do it now it is 
just a rather quick and easy build?).
I'd like to:
- move to the rtd theme
- make translations sync work
- handle the windows build to work good with make.bat (so some static 
copying)
But can be done in steps too

Richard