Skip to content

Docs: formatting issue for Sparkline.add_value #51

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

Merged
merged 1 commit into from
Jul 12, 2022
Merged

Docs: formatting issue for Sparkline.add_value #51

merged 1 commit into from
Jul 12, 2022

Conversation

nicolasff
Copy link

Hello,

The documentation for the add_value method of the Sparkline class has some rendering issues, with the parameters not being listed correctly. The text :param value: and :param update: is visible on the page, instead of having the effect of listing each parameter individually.

Here's how it gets rendered (from this page):

image

I believe this is due to the lack of a new line between the description for the method and the list of parameters. This commits adds the missing line.

See for comparison how this looks for the constructor, there's a gap before :param width:

class Sparkline(displayio.Group):
# pylint: disable=too-many-arguments
"""A sparkline graph.
:param width: Width of the sparkline graph in pixels
:param height: Height of the sparkline graph in pixels

Add missing blank line in the docstring of Sparkline.add_value
Copy link
Member

@tekktrik tekktrik left a comment

Choose a reason for hiding this comment

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

Yeah, that should be the cause, good catch and fix!

@tekktrik tekktrik merged commit e58a062 into adafruit:main Jul 12, 2022
@nicolasff
Copy link
Author

Thanks @tekktrik for the quick review!

It did fix the rendering (same link as above):
image

adafruit-adabot added a commit to adafruit/Adafruit_CircuitPython_Bundle that referenced this pull request Jul 13, 2022
Updating https://github.com/adafruit/Adafruit_CircuitPython_SSD1306 to 2.12.7 from 2.12.6:
  > Merge pull request adafruit/Adafruit_CircuitPython_SSD1306#74 from tekktrik/dev/add-optional-requirements

Updating https://github.com/adafruit/Adafruit_CircuitPython_Display_Shapes to 2.5.1 from 2.5.0:
  > Merge pull request adafruit/Adafruit_CircuitPython_Display_Shapes#51 from nicolasff/patch-1

Updating https://github.com/adafruit/Adafruit_CircuitPython_Logging to 4.1.3 from 4.1.2:
  > Merge pull request adafruit/Adafruit_CircuitPython_Logging#36 from FoamyGuy/docs_attributes_fix
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.

2 participants