DO we know what the latest was for the docs site s...
# development
b
DO we know what the latest was for the docs site switch? Something about waiting for Sphinx stuff in Pants?
h
Even if we scripted it outside of Pants. It's more someone taking the time to deal with it: find a hosting solution with the features we want, experiment with it, convert the existing docs, etc.
Of course supporting it in Pants would be even better, but not necessary perhaps for a first cut, while learning the ropes
b
You might remember my proof-of-concept that just ran sphinx as an
adhoc_tool
(https://github.com/pantsbuild/pants/pull/18851) which would probably be enough for the next step in terms of pants integration after "run Sphinx at all". (i.e. maybe three steps: "use Sphinx to build pants docs", "build pants docs in pants via
adhoc_tool
invoking Sphinx", "add proper sphinx backend to pants and use it for pants docs")
w
In terms of “hosting solution” - my strong recommendation is either CloudFlare Pages (free) or GitHub docs (also free). I have many websites on Cloudflare pages, and trivial is an understatement for deployment. I believe we also use it already for other items? Keeping everything in GitHub is also nice, I’m just less familiar with that approach when it comes to using a specific URL (e.g. pantsbuild.org) If it’s just a generated static site, with some front end JS, then its super straightforward.
The bigger question on hosting is more related to URLs if we want to keep (for example) 1 branch of docs per Pants version - and have each of these on a separate subdomain. That gets mildly more annoying.