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

Enable API doc generation #802

Merged
merged 3 commits into from
Jul 17, 2019
Merged

Enable API doc generation #802

merged 3 commits into from
Jul 17, 2019

Conversation

gitanshu
Copy link
Contributor

@gitanshu gitanshu commented Jul 16, 2019

Closes #755
Closes #647

@gitanshu gitanshu requested a review from a team as a code owner July 16, 2019 22:52
@gitanshu gitanshu requested a review from a team July 16, 2019 22:52
@ghost ghost requested review from cheng-kevin and lywong92 and removed request for a team July 16, 2019 22:52
@ryanjulian ryanjulian changed the title Enable api doc generation Enable API doc generation Jul 16, 2019
@codecov
Copy link

codecov bot commented Jul 16, 2019

Codecov Report

Merging #802 into master will increase coverage by 0.01%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master     #802      +/-   ##
==========================================
+ Coverage   73.25%   73.27%   +0.01%     
==========================================
  Files         175      175              
  Lines       10274    10274              
  Branches     1308     1308              
==========================================
+ Hits         7526     7528       +2     
+ Misses       2377     2375       -2     
  Partials      371      371
Impacted Files Coverage Δ
src/garage/misc/special.py 33.33% <0%> (+3.03%) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 44877ba...c0aa79a. Read the comment docs.

This commit enables generation of api docs from docstrings. It
- adds a minimal requirements.txt to allow installation on
readthedocs
- adds readthedocs.yml to allow configuring readthedocs settings
from code
- adds some packages to autodoc_mock_imports to mock them for
generating docs without installation since readthedocs doesn't
allow installing packages with C library deps, and allows
limited memory usage
- allows writing docs in markdown
@ryanjulian ryanjulian requested review from a team and removed request for cheng-kevin and lywong92 July 17, 2019 18:09
@ghost ghost requested review from cheng-kevin and lywong92 and removed request for a team July 17, 2019 18:09
@ryanjulian ryanjulian merged commit 5c39825 into master Jul 17, 2019
@ryanjulian ryanjulian deleted the fix_doc_gen branch July 17, 2019 18:31
yonghyuc pushed a commit that referenced this pull request Jul 30, 2019
* Adds a minimal requirements.txt to allow installation on
ReadTheDocs
* Adds readthedocs.yml to allow configuring ReadTheDocs settings
from code
- Adds some packages to autodoc_mock_imports to mock them for
generating docs without installation, since ReadTheDocs doesn't
allow installing packages with C library deps, and allows
limited memory usage
- Allows writing docs in markdown
* Updated the documentation link in README.md
gitanshu added a commit that referenced this pull request Nov 5, 2019
gitanshu added a commit that referenced this pull request Nov 5, 2019
gitanshu added a commit that referenced this pull request Nov 5, 2019
gitanshu added a commit that referenced this pull request Nov 5, 2019
gitanshu added a commit that referenced this pull request Nov 5, 2019
gitanshu added a commit that referenced this pull request Nov 5, 2019
gitanshu added a commit that referenced this pull request Nov 5, 2019
gitanshu added a commit that referenced this pull request Nov 5, 2019
gitanshu added a commit that referenced this pull request Nov 5, 2019
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.

Docs builds are failing Fix documentation generation
2 participants