feat(docs): new design for renku docs

[vfried]

New design for docs

/deploy

[RenkuBot]

You can access the deployment of this PR at https://ci-renku-2166.dev.renku.ch

[rokroskar]

This looks really great!! Do you think it would be possible to apply these changes to the renku sphinx theme? That way the other repos that might publish their own documentation pages can use the same theme

[vfried]

Yes, that's a good point... i spoke with ralph this morning to apply this to renku python but it would be easier to apply only to one place. At the moment we are not using the renku theme, we are using the read the docs one and this changes apply to the read the docs theme... https://github.com/readthedocs/sphinx_rtd_theme we could fork these theme and apply this design there.

[rokroskar]

I know we're not using it now, but we used to use it so the repo is already there. It's fine if it's completely overwritten, but having it there would make it easier to maintain.

[vfried]

I will see how i can overwrite the theme in the renku repo then.

[rokroskar]

I think you should be able to copy over the static directory into the theme here and set the RTD theme as the base here

[ciyer]

This looks very nice! 🎉

The suggestions Rok made make sense to me as well. As part of that conversion, I found a couple of files that should probably be removed (see comments), and, as we discussed, I think it would be nice if the css were autogenerated from the scss files (which might require changes to the config and the makefile), but if that is complicated to do, it should be at least documented that the css files should not be edited and how they can be generated.

I will do a full review after the restructuring, but I have already looked at the changes, so I do not expect anything major -- it looks very good!

[vfried]

Changes are now in the renku-sphinx repo.

For testing:

[ciyer]

These look great!

The base branch was changed.

[ciyer]

👍