Use readthedocs?

[choldgraf]

Maybe this is just me being whiny, but I find it difficult to remember the URL of this repository since it's a sub-domain of the jupyterhub github.io page. I'd find nbgitpuller.readthedocs.io easier to remember, since it follows the same pattern that many other orgs do. With jupyterhub.github.io/nbgitpuller I have to remember things like "is nbgitpuller in jupyter/ or jupyterhub/". Would anybody be opposed to using RTD for the docs?

[yuvipanda]

I always use https://nbgitpuller.link ;)

[yuvipanda]

Would links break? IIRC that's why we didn't do it last time, and that's why I bought nbgitpuller.link...

[choldgraf]

oh yeah, I forgot about that URL!

ah pre-existing links you mean...maybe. I guess we could set up sphinx re-directs? How many links to the docs are there out there?

[manics]

I've got no objections. Though

Maybe this is just me being whiny, but I find it difficult to remember the URL of this repository

is slightly concerning- if you have to remember it instead of clicking on a link somewhere obvious does that mean it's not prominent enough?

[choldgraf]

I think my perspective would be reflective of "somebody that uses readthedocs a lot, and knows that nbgitpuller exists, but doesn't have the docs URL memorized". So I default to assuming a project docs are at <projectname>.readthedocs.io and in this case that is a false assumption so I have to google it

[manics]

Is there a decision here? Do people want to move to RTD (and it's a matter of finding time to do it) or is everyone happy with the current URLs?

[choldgraf]

I'm a fan of readthedocs :-)

[manics]

If it helps you can setup redirects in RTD instead of doing it in Sphinx https://docs.readthedocs.io/en/stable/user-defined-redirects.html#prefix-redirects

[choldgraf]

we've also used this in the jupyter book project which has worked well: https://github.com/wpilibsuite/sphinxext-rediraffe

[yuvipanda]

As long as the current URL for nbgitpuller link generator continues to work, I'm happy for this to be wherever :)