-
-
Notifications
You must be signed in to change notification settings - Fork 12
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
ci: Add markdownlint GH workflow #72
Conversation
4994ef5
to
3a7d2f4
Compare
Add markdownlint GH workflow and config file to check all .md files
3a7d2f4
to
4f66bb1
Compare
roles/pcp/README.md
Outdated
pcp_explicit_labels: | ||
### pcp_pmlogger_interval: 10 | ||
### pcp_optional_agents: [dm, nfsclient, openmetrics] | ||
### pcp_explicit_labels: | ||
environment: production |
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.
not sure what markdownlint was complaining about here, but these should not be commented out
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.
Indentation by 4 spaces is a different variant of code block markdown. Markdownlint then complaining about the usual code block formatting because it wants us to use the same syntax consistently.
If you look at the original doc, this code block synatx looks weird. Subtitles suit better here.
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.
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.
You're right, it was some incorrect mass replace on my side. Now it's fixed.
roles/pcp/README.md
Outdated
### pcp_pmlogger_interval: 10 | ||
### pcp_pmlogger_discard: 5 | ||
### pcp_target_hosts: [slip, slop, slap] | ||
### pcp_rest_api: true |
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.
not sure what markdownlint was complaining about here, but these should not be commented out
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.
Agreed, this looks like the same issue as above and the change seems incorrect here.
roles/spark/README.md
Outdated
@@ -53,7 +53,7 @@ Setup export of PCP metrics to a Spark worker thread. | |||
roles: | |||
- role: performancecopilot.metrics.spark | |||
vars: | |||
spark_export_port: 44388 | |||
### spark_export_port: 44388 |
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.
not sure what markdownlint was complaining about here, but these should not be commented out
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.
Yep, same again here - this is an example, and should not be commented like this.
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.
Most changes fine, but looks like a handful of accidentally introduced comment lines.
8614cf2
to
e98b968
Compare
|
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, thanks!
Enhancement: Add markdownlint GH workflow and config file to check all .md files
Reason: Ensure that all markdown files have correct syntax and will be build correctly.