-
Notifications
You must be signed in to change notification settings - Fork 111
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
chore: improve markdownlint #946
Conversation
Markdownlint is a crucial tool for us, but the usability was not as good as it could be. 1. It was confusing, as it was not accessible within the docs 2. The configuration deviated from the defaults, IDE-plugins did not pick up those settings 3. documentation of the setting was missing With this pull-request we address the points above, and make it easier to be used for our contributors. Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
Co-authored-by: Meg McRoberts <mmcroberts@cloudbees.com> Signed-off-by: Simon Schrottner <simon.schrottner@gmail.com>
Co-authored-by: Meg McRoberts <mmcroberts@cloudbees.com> Signed-off-by: Simon Schrottner <simon.schrottner@gmail.com>
Codecov Report
Additional details and impacted files@@ Coverage Diff @@
## main #946 +/- ##
==========================================
+ Coverage 57.45% 57.50% +0.04%
==========================================
Files 119 119
Lines 9913 9914 +1
==========================================
+ Hits 5696 5701 +5
+ Misses 4018 4015 -3
+ Partials 199 198 -1
Flags with carried forward coverage won't be shown. Click here to find out more. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good stuff -- thanks for writing this up! I added some suggestions for your consideration.
Long term, we should move this content to the Contributing guide but let's commit this as is for now.
Also need to link to the info about markdown-lint from the documentation Contributing.md file (see #758 ).
Co-authored-by: Meg McRoberts <mmcroberts@cloudbees.com> Signed-off-by: Simon Schrottner <simon.schrottner@gmail.com>
Co-authored-by: Meg McRoberts <mmcroberts@cloudbees.com> Signed-off-by: Simon Schrottner <simon.schrottner@gmail.com>
Co-authored-by: Meg McRoberts <mmcroberts@cloudbees.com> Signed-off-by: Simon Schrottner <simon.schrottner@gmail.com>
Please do not merge before #866 to reduce merge conflicts :) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM generally, but there is already some small documentation in the docs/README.md
I suggest to remove that if we have it in the contributing file
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
lgtm
@mowies This file has more details than what is in the CONTRIBUTING.md file and covers software facilities as well as the docs build engine. I am thinking that eventually (not real long term) we should make this doc part of the Contributing Guide and then have the CONTRIBUTING.md files point to that guide for info |
Co-authored-by: Giovanni Liva <giovanni.liva@dynatrace.com> Signed-off-by: Simon Schrottner <simon.schrottner@gmail.com>
Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
✅ Deploy Preview for keptn-lifecycle-toolkit ready!
To edit notification comments on pull requests, go to your Netlify site settings. |
Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
7234ce7
to
b0dedde
Compare
Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
lgtm
Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
Kudos, SonarCloud Quality Gate passed!
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
lgtm
Co-authored-by: Meg McRoberts <mmcroberts@cloudbees.com> Co-authored-by: Giovanni Liva <giovanni.liva@dynatrace.com>
Markdownlint is a crucial tool for us, but the usability was not as good as it could be.
With this pull-request we address the points above, and make it easier to be used for our contributors.