Tooling for markdown linting

[Zanda256]

With this pull request, we add a bash script to run linting check on modified or newly added markdown files. We then add a makefile target to run the script using make.

Partially resolves #18059

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: Zanda256
Once this PR has been reviewed and has the lgtm label, please assign spzala for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[k8s-ci-robot]

Hi @Zanda256. Thanks for your PR.

I'm waiting for a etcd-io member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[joshjms]

#18059

[ivanvc]

/ok-to-test

[Zanda256]

@ivanvc could we please give the failing tests a re-run?

[ivanvc]

@ivanvc could we please give the failing tests a re-run?

Yes, you can also do it by yourself by commenting:

/retest

Note: I haven't forgotten about this pull request, but I haven't been able to review it as I have other things in my backlog. I'll return to this soon ✌️

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 68.84%. Comparing base (9f1709e) to head (f4e1d0e).
Report is 4 commits behind head on main.

Additional details and impacted files

see 24 files with indirect coverage changes

@@            Coverage Diff             @@
##             main   #19425      +/-   ##
==========================================
+ Coverage   68.78%   68.84%   +0.06%     
==========================================
  Files         421      421              
  Lines       35901    35901              
==========================================
+ Hits        24693    24716      +23     
+ Misses       9781     9761      -20     
+ Partials     1427     1424       -3     

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 9f1709e...f4e1d0e. Read the comment docs.

🚀 New features to boost your workflow:

• ❄ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[ivanvc]

Thanks for the pull request, @Zanda256. I'm sorry for not getting back to you sooner. I left a couple of comments/suggestions. Thanks again :)

[ivanvc]

Thanks for the changes, @Zanda256. Could you:

1. Please add a new file tools/.markdownlint.jsonc? The contents of the file should be {}
2. Squash your commits into a single one?

This is looking good. I tested locally and it works as expected, we just need these latest changes. Thanks again!