Repository navigation
Previews in pull requests #70
Description
There's been interest expressed in this. This is me trying to have a dedicated place to track that whole discussion. :)
There are a bunch of options for what to do to get PR previews, to make life easier for reviewers of PRs to this theme.
The ones that I know of are:
- ReadTheDocs
- Netlify
Both of these platforms provide free hosting and the ability to preview PRs.
Activity
JulienPalard commentedon May 7, 2021
I created a netlify account to poke around, but I'm at $DAYJOB, I'll continue poking around later.
pradyunsg commentedon May 7, 2021
Netlify has an open source plan, that this project would qualify for: https://www.netlify.com/legal/open-source-policy
JulienPalard commentedon May 8, 2021
Netlify asks for the "Act on your behalf" (WTF!?) permission on my github account in order to make it work, I won't give this, so I can't setup netlify (and I don't think anyone else should do, this permission is just plain scary).
We could create a dedicated low-permission github account to setup netlify, or try something else.
Would it work with readthedocs? I mean, to test it fully we need to setup language and version switchers, I don't see how it can work.
About trying something else, it's just a matter of adding an
rsyncline in the github action, and ... finding a server to host this. @ewdurbin any idea?Maybe we could host this on a github page (like python.github.io/python-docs-theme/pr-123/), by pushing to the github page repo from the github action?
There may be leads around https://github.com/htmlpreview/htmlpreview.github.com too, if it works with js/css (would probably need to massvely rewrite links using sed in the action, leading to other bugs).
Tried to see if we could build a kind of http proxy around artifacts, like:
which would download the zip, cache it, extract it, and provide asked content. But looks like we can't access artifact when not logged in...
Mariatta commentedon May 8, 2021
We discussed adding netlify for the DevGuide here python/devguide#463
In the end we ended up with using readthedocs preview capabilities.
I was wondering if we should have an org account on readthedocs. DevGuide's rtd account is currently a personal one.
CAM-Gerlach commentedon Dec 16, 2022
FYI, the main Python documentation now has Netlify previews, in issue python/cpython#82041 / PR python/cpython#92852 , so there are examples of both platforms in use now for core Python infra.
hugovk commentedon Jan 31, 2023
Please see PR #105.