Add Python API Docs

[thunderbiscuit]

This is a continuation of #635.

@bitkarrot I was not able to rebase and force push to your PR because it uses your master branch which is protected.

Checklists

All Submissions:

• I've signed all my commits
• I followed the contribution guidelines
• I ran cargo fmt and cargo clippy before committing

[thunderbiscuit]

I'm not comfortable enough with my Python to really know whether this is correctly done. I had to ChatGPT my way through reworking the generate_docs.py file, and even then I don't know if this is the proper way to do this.

I don't have a strong opinion on this yet, but it's at least in a workable form and there is probably little harm in adding a few files that build API docs. I'd like comments from other maintainers on this if possible, and from users.

Tagging the crew here: @reez @ItoroD @bitkarrot @rustaceanrob @andreasgriffin.

[rustaceanrob]

Passes the sanity check, although I don't have much to add in terms of Python.

ACK 3942d70

[reez]

This looks almost good to me, but I think it needs one change. I think we need to not ignore index.rst and then add that file back. I think it was ignored/removed in 52514d2 along with all the other items rightfully ignored.

Sphinx documentation doesn't specifically say this verbatim, but it does consistently show index.rst as a manually created and maintained file, while showing auto-generation only for API reference files.

And it also lines up with the error I got building locally Sphinx is unable to load the master document, and was resolved when I added index.rst back and removed it from the .gitignore

Not a python expert, so let me know if I'm off or just what you think, I could be missing something.

Also, one open comment/question: it doesn't look like this auto-deploys docs or anything that I can see, so I was just thinking about the deployment process for these docs, didn't know if someone already had a plan, assuming we would probably want to set something up similar to Jvm/android too but just didn't see anything related to that in this PR