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

fix(docs): add markdownlint and apply rules #4557

Merged
merged 2 commits into from
May 14, 2024

Conversation

jippi
Copy link
Contributor

@jippi jippi commented May 14, 2024

what

  • Set up Markdownlint for ensuring "correctly" (and consistent) formatted markdown in the docs
  • Add GitHub Actions for linting in CI
  • Add npm run website:lint to check linting
  • Add npm run website:lint-fix to check + fix linting where possible
  • Apply linting rules to all markdown files
  • Add .editorconfig to ensure indentation and such are consistent out the box (I picked the odd indent_size: 3 since it what most docs seem to be indented with, normally its 2 or 4, but thats something for future improvements?)

why

Consistency is nice

tests

N/A

references

N/A

@jippi jippi requested review from a team as code owners May 14, 2024 20:17
@jippi jippi requested review from chenrui333, lukemassa and X-Guardian and removed request for a team May 14, 2024 20:17
@chenrui333
Copy link
Member

gonna take a look


[*.md]
indent_style = space
indent_size = 3
Copy link
Member

Choose a reason for hiding this comment

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

why this?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I mentioned it in the OP too; lots of files seem to have 3 indentation size, rather than even, so went with it to make sure its consistent - reindenting to 2 or 4 is something I can do as a follow-up (going to be braindead work lol)

Copy link
Member

Choose a reason for hiding this comment

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

oh okay, let's followup on this 😄

@@ -1,3 +1,6 @@
---
aside: false
Copy link
Contributor Author

Choose a reason for hiding this comment

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

these hides the right nav; those page looks better without them, and it only has a single item there anyway

Copy link
Member

Choose a reason for hiding this comment

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

make sense 👍

Copy link
Member

@chenrui333 chenrui333 left a comment

Choose a reason for hiding this comment

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

lgtm just one minor question about the indent_size for md

@chenrui333 chenrui333 merged commit 6fe0303 into runatlantis:main May 14, 2024
24 checks passed
@chenrui333
Copy link
Member

Love it, 🚢

@jippi jippi deleted the markdownlint branch May 14, 2024 20:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants