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

Format Markdown and Python code in docs #343

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

Conversation

john-kurkowski
Copy link
Owner

Changes

  • Format Python code in docstrings, via Ruff
  • Format Markdown, via mdformat
  • Format Python code within Markdown, via mdformat-ruff
    • Switch Python doctest code within Markdown (with leading >>>) to plain Python

Commentary

I'm not positive I want this PR. The impact is pretty minor. I don't know if I want yet another tool to depend on. This came about while I was updating docs and noticing slight style inconsistencies. I stumbled across the tools and settings to remove the inconsistencies, and wanted to see what it'd be like, in this PR. 🤷‍♂️

* Format Python code within Markdown, via mdformat-ruff
* Switch Python doctest code within Markdown (with leading `>>>`) to plain Python
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.

1 participant