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

Pre-commit and format markdown #682

Merged
merged 4 commits into from
Dec 17, 2024
Merged

Conversation

nllong
Copy link
Member

@nllong nllong commented Dec 16, 2024

Any background context you want to provide?

Small tweaks to the updated mkdocs migration!

What does this PR accomplish?

  • Add markdown linter and formatter
  • fix spellings
  • changelog -> change log
  • e.g. | i.e. -> e.g., i.e,
  • un-indent code blocks

@nllong nllong changed the title initial formatting Pre-commit and format markdown Dec 16, 2024
@nllong nllong force-pushed the fall-2024-docs-formatting branch from 2bcf99f to ac94cea Compare December 16, 2024 22:58
@nllong nllong marked this pull request as ready for review December 16, 2024 23:06
@nllong nllong requested a review from vtnate December 16, 2024 23:06
@nllong nllong mentioned this pull request Dec 16, 2024
@@ -155,7 +155,7 @@ def replace_within_string(self, new_string: str) -> None:
"""
self.within = new_string

def find_model_object(self, obj_name: str) -> Tuple[Union[int, None], Union[str, None]]:
def find_model_object(self, obj_name: str) -> tuple[Union[int, None], Union[str, None]]:
Copy link
Contributor

Choose a reason for hiding this comment

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

Since we now require Python 3.10, type hints can be simpler. We don't need to import Union any more, we can just do tuple[int | None, str | None]. I think (though I'm less confident) we also don't need to import Any now either.

Mostly meant as a reminder, not suggesting we tear apart the code looking for that!

- repo: https://github.com/igorshubovych/markdownlint-cli
rev: v0.43.0
hooks:
- id: markdownlint
Copy link
Contributor

Choose a reason for hiding this comment

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

Linting in pre-commit is good for the soul 🫶

@vtnate vtnate merged commit c3ace89 into fall-2024-docs Dec 17, 2024
8 checks passed
@vtnate vtnate deleted the fall-2024-docs-formatting branch December 17, 2024 15:55
vtnate added a commit that referenced this pull request Dec 17, 2024
* remind users they may need to scroll to see MBL version in compatibility matrix

* remove `update_schemas` script

* initial changes to text

* change dependencies to use mkdocs for documentation

* config file for mkdocs

* ignore intermediate schema conversion files for docs site

* rename sys-param schema file to be more descriptive

* improve release & docs documentation

* re-organize dev dependencies

* new mkdocs version of documentation, removing rst

* GHA workflow to deploy docs

* add link to docs site at top of readme

* remove sphinx docs build from CI

* rename overview doc file for intuitive nav

* put authors file into a markdown table

* Pre-commit and format markdown (#682)

* initial formatting

* fix issues, general cleanup

* un-indent code blocks, fix changelog header

* e.g., and i.e.,

---------

Co-authored-by: Nicholas Long <[email protected]>
Co-authored-by: Nicholas Long <[email protected]>
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