Trying to run

$ ./pants run build-support/bin/generate_docs.py                     
Generating docs for Pants 2.13. Is this the correct version? [Y/n]: y

on the latest

main

checkout. Getting:

...
[INFO]:   <https://www.pantsbuild.org/v2.13/docs/targets>
[INFO]:   <https://www.pantsbuild.org/v2.13/docs/thrift-python>
[INFO]:   <https://www.pantsbuild.org/v2.13/docs/upgrade-tips>
[INFO]: Fetching titles...
Error getting URL: <https://www.pantsbuild.org/v2.13/docs/python-test-goal>

If the URL is <http://pantsbuild.org|pantsbuild.org>, a `doc_url` link might be using the wrong slug or the docs for this version might be unpublished. Otherwise, the link might be dead.

You can use `--skip-check-urls` to skip.

Visiting https://www.pantsbuild.org/v2.13/docs/python-test-goal gives me 404. Is this an issue?

If you run it on

main

you are basically forced to use

--skip-check-urls

, because

main

always uses unpublished doc links 😕

yeah, this is expected b/c we haven't forked the 2.13 docs yet. I gave you bad advice in the PR, sorry

At some point we'll make this a first-class-goal in a pants-repo-internal plugin. Then we can porbably request the Git info and skip URL checking on

main

. Plus other nicities

no problem, Eric! Thanks Joshua. Skipping urls check does work, just wanted to double-check!