documentation: Get Read the Docs working

[speller26]

Issue #, if available:

Description of changes:

Fixed previously failing Read the Docs builds by:

1. Explicity adding method and path to .readthedocs.yml; this was causing builds to fail altogether
2. Using sphinxcontrib-apidoc instead autodoc directly (see Support auto-generated API docs readthedocs/readthedocs.org#1139). Defore, our tox -e docs command would run aphinx-apidoc then sphinx-build. However, Read the Docs only runs sphinx-build, so the module docs would never get generated.

Testing done:

build_files.tar.gz

Merge Checklist

Put an x in the boxes that apply. You can also fill these out after creating the PR. If you're unsure about any of them, don't hesitate to ask. We're here to help! This is simply a reminder of what we are going to look for before merging your pull request.

General

• I have read the CONTRIBUTING doc
• I used the commit message format described in CONTRIBUTING
• I have updated any necessary documentation, including READMEs and API docs (if appropriate)

Tests

• I have added tests that prove my fix is effective or that my feature works (if appropriate)
• I have checked that my tests are not configured for a specific region or account (if appropriate)

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[amazon-braket-ci-bot]

AWS CodeBuild CI Report

• CodeBuild project: DefaultSimulatorPullRequestBuild
• Commit ID: 58be508
• Result: SUCCEEDED
• Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository