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

Add exception docs #3490

Merged
merged 5 commits into from
Jan 6, 2019
Merged

Conversation

dave-shawley
Copy link
Contributor

What do these changes do?

A few simple documentation changes to enable linking to aiohttp.web.Response and aiohttp.web.HTTPException using sphinx.ext.intersphinx. Previously the class documentation for Response was not indented properly so a link was not generated in objects.inv. I added class documentation for aiohttp.web.HTTPException that refers to the existing exception documentation.

Are there changes in behavior for the user?

Nope. No changes in behavior whatsoever.

Related issue number

Not that I am aware of.

Checklist

  • I think the code is well written (N/A)
  • Unit tests for the changes exist (N/A)
  • Documentation reflects the changes
  • If you provide code modification, please add yourself to CONTRIBUTORS.txt
    • The format is <Name> <Surname>.
    • Please keep alphabetical order, the file is sorted by names.
  • Add a new news fragment into the CHANGES folder
    • name it <issue_id>.<type> for example (588.bugfix)
    • if you don't have an issue_id change it to the pr id after creating the pr
    • ensure type is one of the following:
      • .feature: Signifying a new feature.
      • .bugfix: Signifying a bug fix.
      • .doc: Signifying a documentation improvement.
      • .removal: Signifying a deprecation or removal of public API.
      • .misc: A ticket has been closed, but it is not of interest to users.
    • Make sure to use full sentences with correct case and punctuation, for example: "Fix issue with non-ascii contents in doctest text files."

Indent the parameters for Response in the class documentation so that
the link to it is generated.
@codecov-io
Copy link

codecov-io commented Jan 6, 2019

Codecov Report

Merging #3490 into master will decrease coverage by 0.02%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master    #3490      +/-   ##
==========================================
- Coverage   97.95%   97.93%   -0.03%     
==========================================
  Files          44       44              
  Lines        8554     8554              
  Branches     1377     1377              
==========================================
- Hits         8379     8377       -2     
- Misses         71       72       +1     
- Partials      104      105       +1
Impacted Files Coverage Δ
aiohttp/web_fileresponse.py 96.55% <0%> (-1.15%) ⬇️

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 c9dabcb...877b9b9. Read the comment docs.

@asvetlov asvetlov merged commit 3a0c7bf into aio-libs:master Jan 6, 2019
@asvetlov
Copy link
Member

asvetlov commented Jan 6, 2019

Thanks!

asvetlov pushed a commit that referenced this pull request Jan 6, 2019
* Fix aiohttp.web.Response docs.
* Adjust json_response TOC level.
* Add HTTPException class documentation.
(cherry picked from commit 3a0c7bf)

Co-authored-by: dave-shawley <daveshawley@gmail.com>
asvetlov added a commit that referenced this pull request Jan 6, 2019
* Fix aiohttp.web.Response docs.
* Adjust json_response TOC level.
* Add HTTPException class documentation.
(cherry picked from commit 3a0c7bf)

Co-authored-by: dave-shawley <daveshawley@gmail.com>
@dave-shawley dave-shawley deleted the add-exception-docs branch January 7, 2019 11:39
@lock
Copy link

lock bot commented Jan 7, 2020

This thread has been automatically locked since there has not been
any recent activity after it was closed. Please open a new issue for
related bugs.

If you feel like there's important points made in this discussion,
please include those exceprts into that new issue.

@lock lock bot added the outdated label Jan 7, 2020
@lock lock bot locked as resolved and limited conversation to collaborators Jan 7, 2020
@psf-chronographer psf-chronographer bot added the bot:chronographer:provided There is a change note present in this PR label Jan 7, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
bot:chronographer:provided There is a change note present in this PR outdated
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants