Skip to content

fix: minor documentation formatting issues #7469

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

Draft
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

gvwilson
Copy link
Contributor

@gvwilson gvwilson commented Jul 15, 2025

Minor documentation fixes needed for switch in plotly.py documentation framework. Paired with plotly/plotly.py#5276 (which generates Python documentation using mkdocs).

  • Put back-quotes around HTML tags in src/components/annotations/attributes.js
    so that they are not interpreted literally in Python Markdown documentation.
  • Fix mis-matched asterisk and back-quote in src/components/errorbars/attributes.js.
  • Format comparison operators and interval operators in src/traces/contour/attributes.js
    as back-quoted text so that angle brackets and square brackets don't confuse
    Markdown formatting in Python documentation.

To do:

  • CONTRIBUTING.md says python scripts/updatejs.py --dev --devrepo reponame --devbranch branchname but commands.py didn't appear to support --devrepo or --devbranch.
  • CONTRIBUTING.md also mentions --local which commands.py also didn't provide.

@gvwilson gvwilson self-assigned this Jul 15, 2025
@gvwilson gvwilson added P1 needed for current cycle fix fixes something broken documentation written for humans labels Jul 15, 2025
@gvwilson gvwilson force-pushed the fix-doc-formatting branch from 503a303 to a795c9f Compare July 16, 2025 18:51
@gvwilson gvwilson requested a review from LiamConnors July 16, 2025 18:53
…arkdown.

- Put back-quotes around HTML tags in `src/components/annotations/attributes.js`
  so that they are not interpreted literally in Python Markdown documentation.

- Fix mis-matched asterisk and back-quote in
  `src/components/errorbars/attributes.js`.

- Format comparison operators and interval operators in
  `src/traces/contour/attributes.js` as back-quoted text so that angle brackets
  and square brackets don't confuse Markdown formatting in Python documentation.
@gvwilson gvwilson force-pushed the fix-doc-formatting branch from a795c9f to c1649b4 Compare July 17, 2025 12:40
@archmoj
Copy link
Contributor

archmoj commented Jul 17, 2025

Thanks @gvwilson.
Could you apply changes in this https://github.com/plotly/plotly.js/pull/7302/files here and close that one please?

Correct wrong description of hovertemplate regarding the use of tag `<extra>`
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation written for humans fix fixes something broken P1 needed for current cycle
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants