Skip to content

Conversation

@FThompsonAWS
Copy link
Contributor

@FThompsonAWS FThompsonAWS commented Aug 18, 2020

Issue #, if available: N/A

Description of changes:
This PR adds doc generation using Sphinx and updates existing docstrings to use a formatted supported by Sphinx.
The doc output can be hosted on GitHub Pages with /docs/html as the root, for example.

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

@jmklix jmklix linked an issue Aug 18, 2020 that may be closed by this pull request
Copy link
Contributor

@TingDaoK TingDaoK left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for the PR. Only thing I want to bring up is how should we link from the doc for aws-iot-device-sdk-python-v2 to the doc of aws-crt-python. So, lots of the APIs used here is based on aws-crt-python. We will need a proper way to reference to the doc of aws-crt-python to make it more clear.

@FThompsonAWS FThompsonAWS force-pushed the docs branch 3 times, most recently from 1d06009 to c184ce9 Compare September 3, 2020 17:33
- replace doc makefile with python script
  - run `python3 make-docs.py` to regenerate docs
@graebm graebm merged commit 7ae2782 into master Sep 4, 2020
@graebm graebm deleted the docs branch September 4, 2020 20:36
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.

API Documentation

3 participants