🏗✨：include new markdown linter

[DerekNonGeneric]

WIP of incorporating new markdown linter into our workflows

[netlify]

👷 Deploy Preview for open-inf-is processing.

Name	Link
🔨 Latest commit	21daa41
🔍 Latest deploy log	https://app.netlify.com/sites/open-inf-is/deploys/65fbe3c77cb9b3000809d1e5

[DerekNonGeneric]

this pr is prereq to #1123 and others;
see #1123 (comment)

[DerekNonGeneric]

i took this from https://github.com/OpenINF/.github/blob/main/build/tasks/verify/verify-md.mjs, but am noticing it has problems now…

[DerekNonGeneric]

ok, we are just going to go w/ the flow on this a quickly merge so we can get back to work

[DerekNonGeneric]

humm, bundle exec github-linguist --breakdown --json | jq '.Markdown.files' returns
null at the moment…

for some reason all Markdown files are being ignored by linguist currently:

🔗 https://github.com/github-linguist/linguist/blob/4ac734c15a96f9e16fd12330d0cb8de82274f700/lib/linguist/blob_helper.rb#L239
🔗 https://github.com/github-linguist/linguist/blob/4ac734c15a96f9e16fd12330d0cb8de82274f700/lib/linguist/documentation.yml#L30

🔗 https://github.com/github-linguist/linguist/blob/4ac734c15a96f9e16fd12330d0cb8de82274f700/docs/overrides.md?plain=1#L56

[DerekNonGeneric]

oh my goodness lol:

🔗 https://github.com/OpenINF/.github/blob/main/.gitattributes#L1

[DerekNonGeneric]

dang, linguist is still being annoying and not properly detecting documentation (even following documented way of overriding in .gitattributes)

[DerekNonGeneric]

oh wow, looks like we have a little more to go:

🔗 https://github.com/DavidAnson/markdownlint-cli2?tab=readme-ov-file#compatibility

[socket-security]

New and removed dependencies detected. Learn more about Socket for GitHub ↗︎

Package	New capabilities	Transitives	Size	Publisher
npm/@iktakahiro/markdown-it-katex@4.0.1	Transitive: filesystem, shell	+2	3.94 MB	iktakahiro
npm/markdown-it-abbr@2.0.0	None	0	21.2 kB	vitaly
npm/markdown-it-anchor@8.6.7	None	+3	202 kB	valeriangalliat
npm/markdown-it-footnote@4.0.0	None	0	46.8 kB	vitaly
npm/markdown-it-sub@2.0.0	None	0	9.57 kB	vitaly
npm/markdown-it-sup@2.0.0	None	0	9.61 kB	vitaly
npm/markdown-it-task-lists@2.1.1	None	0	23.1 kB	revin
npm/markdown-it-toc-done-right@4.2.0	None	0	73.8 kB	nagaozen
npm/markdown-it@14.1.0	Transitive: environment, filesystem	+6	1.49 MB	vitaly
npm/markdownlint-cli2-formatter-default@0.0.4	None	0	5.19 kB	davidanson
npm/markdownlint-cli2@0.12.1	Transitive: environment, filesystem	+34	3.56 MB	davidanson

🚮 Removed packages: npm/vnu-jar@23.4.11

View full report↗︎

[DerekNonGeneric]

well, we will have to do a follow-up (tomorrow);
seems the exit code doesn't fail ci;
see https://github.com/OpenINF/openinf.github.io/actions/runs/8371423211/job/22920438981?pr=1184

also, would like everything wrong w/ those documents to be corrected