Skip to content

Autodocs #313

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Apr 22, 2022
Merged

Autodocs #313

merged 4 commits into from
Apr 22, 2022

Conversation

graebm
Copy link
Contributor

@graebm graebm commented Apr 22, 2022

Automated update the API documentation published to https://aws.github.io/aws-iot-device-sdk-python-v2/

Issue:

  • Docs weren't updated unless someone remembered to do it manually.
  • Manually updating docs whenever you update code pollutes the diff, making it hard to review
  • Having HTML docs in main branch can cause issues.
    • Bloats size.
    • Generated docs might contain licenses we don't want to be redistributing.

Description of changes:

  • Docs are kept in docs branch now
    • New docs.yml Github Workflow updates the docs branch whenever the main branch changes.
    • New check-docs job in ci.yml checks pull-requests for anything that would break docs.
    • delete the docs/ folder in main and use .gitignore to prevent someone from accidentally resurrecting it.

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

@graebm graebm marked this pull request as ready for review April 22, 2022 03:16
@graebm graebm merged commit 0c1dd46 into main Apr 22, 2022
@graebm graebm deleted the autodocs branch April 22, 2022 21:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants