README has clean lint

README.md

@@ -50,7 +50,7 @@ The software table is generated on each deploy on GitHub actions,
 so you have to do that manually if you want to view it locally:
 
 ``` bash
-python3 scripts/sw_table_md_creator.py -i https://export.uppmax.uu.se/staff/software_table_ci/software_table.json -o docs/software/software-table.md
+./scripts/create_software_table.sh
 ```
 
 ### Text-to-speech
@@ -82,4 +82,3 @@ The website is created using
 [mkdocs-material](https://squidfunk.github.io/mkdocs-material). The landing
 page and layout was inspired by the documentation of the HPC cluster
 [LUMI](https://docs.lumi-supercomputer.eu/).
-

scripts/create_software_table.md

@@ -0,0 +1,24 @@
+#!/bin/bash
+#
+# Create the software table.
+#
+# The software table is generated on each deploy on GitHub actions,
+# so you have to do that manually if you want to view it locally:
+#
+# Usage:
+#
+#   ./scripts/create_software_table.sh
+
+if [[ "$PWD" =~ scripts$ ]]; then
+    echo "FATAL ERROR."
+    echo "Please run the script from the project root. "
+    echo "Present working director: $PWD"
+    echo " "
+    echo "Tip: like this"
+    echo " "
+    echo "  ./scripts/create_software_table.sh"
+    echo " "
+    exit 42
+fi
+
+python3 scripts/sw_table_md_creator.py -i https://export.uppmax.uu.se/staff/software_table_ci/software_table.json -o docs/software/software-table.md

scripts/fix_markdown_style_errors.sh

@@ -19,6 +19,24 @@ if [[ "$PWD" =~ scripts$ ]]; then
     exit 42
 fi
 
-markdownlint '**/*.md' --ignore node_modules --fix
+#
+# This is too powerful, as it unindents:
+#
+#########################################
+# ???- question "A question?"
+#
+#     Some text that needs to be indented
+#########################################
+#
+# to
+#
+#########################################
+# ???- question "A question?"
+#
+# Some text that needs to be indented
+#########################################
+#
+
+# markdownlint --fix '**/*.md' --ignore node_modules --fix
 
 # ./scripts/remove_trailing_spaces.sh