Skip to content
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

feat(doc): Using Sphinx to autogenerate documentation for the SDK #262

Merged
merged 15 commits into from
May 14, 2020

Conversation

yavorona
Copy link
Contributor

@yavorona yavorona commented May 14, 2020

Summary

Introducing autogenerated documentation using Sphinx

yavorona and others added 15 commits May 14, 2020 10:49
* Create script to generate html docs with sphinx
Add minor changes to README.md and CONTRIBUTING.md for proper conversion to .rst

* Address comments

* Clean up

Co-authored-by: Polina Nguen <[email protected]>
…cs (#244)

* Include docstrings from bucketer.py and decision_service.py to the docs

* Fix Travis failure

Co-authored-by: Polina Nguen <[email protected]>
#245)

Update buckering_algorithm to exclude namedtuble docstrings

Co-authored-by: Polina Nguen <[email protected]>
…ings to the docs (#246)

* Added optimizely.py to docs

* Returned to having private methods included for now.

* Added optimizely.py, event_builder.py, and event_dispatcher.py to the docs

Co-authored-by: Polina Nguen <[email protected]>
* Added optimizely.py to docs

* Returned to having private methods included for now.

* Added optimizely.py, event_builder.py, and event_dispatcher.py to the docs

* Added user_profile.py and logger.py docstrings to docs
Moved all api_reference components into one rst file

Co-authored-by: Polina Nguen <[email protected]>
* Added optimizely.py to docs

* Returned to having private methods included for now.

* Added optimizely.py, event_builder.py, and event_dispatcher.py to the docs

* Add version to docs

* Update branch

Co-authored-by: Polina Nguen <[email protected]>
* Change pip8 to flake8

* Update contributing link to work in sphinx docs

* Remove Event Builder

* Change “Bucketing Algorithm Methods” to “Bucketing”

* Update project name

* Include README to table of contents

* Create readme.rst for readme.md
* Fix table in Advanced configuration

* Fix anchor
* Create README for sphinx docs

* Fix spelling

* Update README.md

Add title

* Incorporate Ali's comments
…it Options in class Optimizely (#259)

* Remove bucketing algorithm section

* Add __init__ to class optimizely.optimizely.Optimizely
@yavorona yavorona requested a review from a team as a code owner May 14, 2020 18:09
@aliabbasrizvi aliabbasrizvi changed the title Sphinx docs feat(doc): Using Sphinx to autogenerate documentation for the SDK May 14, 2020
Copy link
Contributor

@aliabbasrizvi aliabbasrizvi left a comment

Choose a reason for hiding this comment

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

LGTM

@coveralls
Copy link

Coverage Status

Coverage remained the same at 97.097% when pulling f08c713 on sphinx-docs into 61fddb0 on master.

@yavorona yavorona merged commit 9d18756 into master May 14, 2020
@yavorona yavorona deleted the sphinx-docs branch May 14, 2020 18:18
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.

3 participants