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

ci: Add markdownlint GH workflow #72

Merged
merged 2 commits into from
Sep 24, 2024

Conversation

spetrosi
Copy link
Contributor

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.

@spetrosi spetrosi force-pushed the markdownlint-init branch 2 times, most recently from 4994ef5 to 3a7d2f4 Compare September 20, 2024 09:43
Add markdownlint GH workflow and config file to check all .md files
pcp_explicit_labels:
### pcp_pmlogger_interval: 10
### pcp_optional_agents: [dm, nfsclient, openmetrics]
### pcp_explicit_labels:
environment: production
Copy link
Contributor

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

Copy link
Contributor Author

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.

Copy link
Member

Choose a reason for hiding this comment

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

@spetrosi I think the change is fine for all except those last three lines @richm has called out - this is an example and I think these have accidentally been turned into comments here?

Copy link
Contributor Author

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.

### pcp_pmlogger_interval: 10
### pcp_pmlogger_discard: 5
### pcp_target_hosts: [slip, slop, slap]
### pcp_rest_api: true
Copy link
Contributor

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

Copy link
Member

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.

@@ -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
Copy link
Contributor

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

Copy link
Member

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.

Copy link
Member

@natoscott natoscott left a 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.

@spetrosi
Copy link
Contributor Author

spetrosi commented Sep 23, 2024

Most changes fine, but looks like a handful of accidentally introduced comment lines.

# marks a title in markdown. The more #s, the more title is indented.

Copy link
Member

@natoscott natoscott left a comment

Choose a reason for hiding this comment

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

LGTM, thanks!

@spetrosi spetrosi merged commit 7e3b8f6 into performancecopilot:main Sep 24, 2024
6 checks passed
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.

3 participants