-
Notifications
You must be signed in to change notification settings - Fork 20
now renders API Reference page correctly #17
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
Conversation
autodocs showing inheritence, but `AnalogIn.__init__()`'s `positive_pin` & `negative_pin` parameters are not DigitalInOut objects
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@2bndy5 Thank you for your work on the API documentation for this library and general sphinx/syntax fixes.
I requested a few things to be resolved before merging this into master
.
I can't open the conflicting example file here on the PR to see how removing one argument on one line would cause a conflict. |
OK not sure how it happened or even how I resolved it, but using |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@2bndy5 Thank you for editing the PR, looks great. Merging in...
Updating https://github.com/adafruit/Adafruit_CircuitPython_MCP3xxx to 1.1.2 from 1.1.1: > Merge pull request adafruit/Adafruit_CircuitPython_MCP3xxx#17 from 2bndy5/master Updating https://github.com/adafruit/Adafruit_CircuitPython_RA8875 to 2.0.1 from 2.0.0: > Merge pull request adafruit/Adafruit_CircuitPython_RA8875#13 from makermelissa/master Updating https://github.com/adafruit/Adafruit_CircuitPython_Bundle/circuitpython_library_list.md to NA from NA: > Added the following libraries: Adafruit_CircuitPython_AWS_IOT
Looking at the PR of this library in the past, I see the @sommersoft opened issue #7 that had suggested adequate changes to api.rst, but it was closed upon merge of this PR without including the suggested changes. So I did exactly that and then some:
MCP3xxx
as their base class (to avoid confusion) using autodoc's:show-inheritence:
directive.AnalogIn
's constructor wasn't getting documented because of the odd placement of its__get__
magic method before__init__
.AnalogIn
's constructor to more accurately link to the appropriate objects. See these lines for what I mean.AnalogIn
's constructor in both the examples/mcp3xxx_mcp3004_single_ended_simpletest.py and the corresponding copied code in the README.rst files.