Removing API docs from PDF

[john-science]

What is the change? Why is it being made?

WIP: Ignore for now.

Removing API docs from PDF, as they are not easy to read in PDF format, and make the ARMI docs over 1,600 pages long in PDF.

close #2288

SCR Information

Change Type: docs

One-Sentence Description: Removing API docs from PDF
One-Sentence Rationale: People were asking for a smaller PDF file.

One-line Impact on Requirements: NA

---

Checklist

• This PR has only one purpose or idea.
• Tests have been added/updated to verify any new/changed code.
• The documentation is still up-to-date in the doc folder.
• The code style follows good practices.
• The dependencies are still up-to-date in pyproject.toml.

[john-science]

Okay, this is proving somewhat harder than anticipated. The turn-around time on testing through github is just too long.

[john-science]

Okay, after several attempts I have not figured out a working approach here that doesn't add 10 minutes to the build time.

So I am going to close this PR and maybe someone else will figure out a smarter approach.

[john-science]

@opotowsky Commit d7dc62f finally removed the API docs from the PDF!

BUT. That completely breaks the SQA docs. Without the apidocs, Sphinx-Needs can't render the impl or test tags:

So, long story short, I am back to the drawing board on this.

[john-science]

Okay, I want to try removing this line from the index.rst file to see if that is enough all on it's own:

armi/doc/index.rst

Line 19 in a697790

API Docs <.apidocs/modules>

If it isn't, and I get the same problem as above, then I think there is no way to solve this without having a very different conf.py file and docs build for the PDF.