Fix issues in Markdown doc files

[wenzeslaus]

Essential:

• implement fixes to remove ignores in linting config
• remove block quotes from r.green tools
• inspect images (by sampling, regexp)
• reduce cases where sh code blocks are used for things which are not sh docs: fix code blocks language #1359

Transition-related:

• put back meta page (name and description info) as YAML headers and level 1 headings docs: Use meta page info from HTML in Markdown #1347

Optional:

• make Markdown tooling understand that some code blocks in r.fuzzy.system doc are its own specific syntax (and not an unnecessary $ sign in a Bash example). Replaced by local disable checks: Enable markdownlint commands-show-output #1356.

Originally listed here, but later identified as out of scope:

• check for image-alt text (The alt text was missing before and it does not break anything in the MkDocs.)
• update r.landscape.evol Markdown to new doc #1374

[wenzeslaus]

Missing here:

• Update r.landscape.evol Markdown to new doc. (It had Markdown before, so that Markdown file was preserved, but it is in a different style than the other Markdown files.)
• Reduce cases where sh code blocks are used for things which are not sh (code blocks marked as sh which are in fact Python examples or plain text output).

[isaacullah]

Vaclav, what kinds of changes are needed for r.landscape.evol markdown to come into compliance? I can do this with a little guidance if necessary. ~Isaac

[petrasovaa]

Vaclav, what kinds of changes are needed for r.landscape.evol markdown to
come into compliance? I can do this with a little guidance if necessary.

~Isaac

I am not sure either, it is compliant with with setting in the markdown linter. So maybe some of the subheadings could be more semantically correct, e.g. you could remove the numbering from the subheadings and then things like "a) GIS Implementation:" could be "#### GIS Implementation"

[isaacullah]

Ok, thanks Anna! I will make some time to work on this... ~Isaac

…

On Wed, Mar 12, 2025 at 7:04 AM Anna Petrasova ***@***.***> wrote: Vaclav, what kinds of changes are needed for r.landscape.evol markdown to come into compliance? I can do this with a little guidance if necessary. ~Isaac I am not sure either, it is compliant with with setting in the markdown linter. So maybe some of the subheadings could be more semantically correct, e.g. you could remove the numbering from the subheadings and then things like "a) GIS Implementation:" could be "#### GIS Implementation" — Reply to this email directly, view it on GitHub <#1333 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACDYS5DLJ5KBWO7CMZMVPP32UA5GXAVCNFSM6AAAAABXRQRQ2SVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDOMJXHE4TGOJQGY> . You are receiving this because you commented.Message ID: ***@***.***> [image: petrasovaa]*petrasovaa* left a comment (OSGeo/grass-addons#1333) <#1333 (comment)> Vaclav, what kinds of changes are needed for r.landscape.evol markdown to come into compliance? I can do this with a little guidance if necessary. ~Isaac I am not sure either, it is compliant with with setting in the markdown linter. So maybe some of the subheadings could be more semantically correct, e.g. you could remove the numbering from the subheadings and then things like "a) GIS Implementation:" could be "#### GIS Implementation" — Reply to this email directly, view it on GitHub <#1333 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ACDYS5DLJ5KBWO7CMZMVPP32UA5GXAVCNFSM6AAAAABXRQRQ2SVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDOMJXHE4TGOJQGY> . You are receiving this because you commented.Message ID: ***@***.***>

--

___________________________________________________________________________ Isaac I. Ullah, PhD *Recent papers:* Laborscapes and Archaeologies of Sustainability: http://dx.doi.org/10.1558/jma.39327 Water, dust, and loess: co-evolution of landscapes, farming, and human society: https://doi.org/10.1016/j.jaa.2019.101067 Modeling feedbacks between human and natural processes in the land system: https://doi.org/10.5194/esd-9-895-2018 <https://doi.org/10.5194/esd-9-895-2018> <https://doi.org/10.5194/esd-9-895-2018>

[wenzeslaus]

@isaacullah I removed the r.landscape.evol issue from here and moved it to a separate issue.

I'm closing this as completed as all individual todos are now completed.