20240131 Update readthedocs generation

[mkeilman]

Precipitated by this notification. Investigate how they currently generate this documentation vs the new method and make changes accordingly.

See also #37

• Make readthedocs conform to current build process #429
• Extract readthedocs content from pksetup to a pkcli #393
• Create installer for readthedocs download#526
• radiasoft/devsecops#521

To clarify a bit, here's what readthedocs is expecting in the repo of interest:

• .readthedocs.yml at the root level, minimally:

version: 2

build:
  os: ubuntu-22.04
  tools:
    python: "3.9"
  jobs:
    pre_build:
     - <commands to run>

sphinx:
  configuration: docs/conf.py

python:
    install:
    - requirements: docs/requirements.txt

• docs/conf.py
• docs/requirements.txt

In the current state of PR #392, "commands to run" is python setup.py install --force (which readthedocs used to do automatically). That's done to run pksetup, which generates the conf.py above; accordingly, requirements.txt contains pykern. The purpose of #393 is to take pksetup out of the process and the purpose of radiasoft/download#526 is to make "commands to run" something like curl https://radia.run | bash -s readthedocs

[mkeilman]

Another relevant post

[robnagler]

@mkeilman how is this going?

[mkeilman]

@mkeilman how is this going?

Taken a back seat to other things, but I just got an email about adding secrets to webhooks. I don't know how that affects our projects, but in any case I'll give it my attention again. The email references a Jan. 31 deadline - that's a reasonable timeframe to complete this issue as well I think.