[FIX] misc minor fixes to the documentation

.gitignore

@@ -1,6 +1,11 @@
 .DS_Store
-.idea/
 activities/.DS_Store
 protocols/.DS_Store
+
+.idea/
+
 node_modules
 local_data
+
+package-lock.json
+package.json

.pre-commit-config.yaml

@@ -10,6 +10,7 @@ repos:
     -   id: check-json
     -   id: check-ast
     -   id: check-added-large-files
+    -   id: check-merge-conflict
 -   repo: https://github.com/psf/black
     rev: 24.3.0
     hooks:

.remarkrc

@@ -0,0 +1,18 @@
+{
+  "plugins": [
+    "preset-lint-markdown-style-guide",
+    "preset-lint-recommended",
+    "remark-gfm",
+    ["lint-no-duplicate-headings", false],
+    ["lint-list-item-indent", "tab-size"],
+    ["lint-emphasis-marker", "consistent"],
+    ["lint-maximum-line-length", 500],
+    ["lint-maximum-heading-length", false],
+    ["lint-no-shortcut-reference-link", false],
+    ["remark-lint-unordered-list-marker-style", "-"],
+    ["lint-no-trailing-spaces"],
+    ["remark-lint-code-block-style", false],
+    ["lint-no-undefined-references", false],
+    ["remark-lint-heading-style", false]
+  ]
+}

README.md

@@ -39,7 +39,7 @@ following libraries via pip
 
 To make a new release:
 
-```
+```bash
 python scripts/makeRelease.py <version>
 python scripts/editProperties.py <version>
 ```

docs/100_about_this_doc.md → docs/CONTRIBUTING.md

@@ -1,15 +1,18 @@
-# About this documentation
+# Contributing
 
-This documentation is a work in progress and we wellcome any input: if something is missing or unclear, let us know by [opening an issue on our repository] (???).
+## Contributing to the documentation
 
-## Serving the doc locally
+This documentation is a work in progress and we wellcome any input:
+if something is missing or unclear, let us know by opening an issue on our repository.
+
+### Serving the doc locally
 
 This project uses [MkDocs](https://www.mkdocs.org/) tool with [Material theme](https://squidfunk.github.io/mkdocs-material/)
 and extra plugins to generate the website.
 
 To test locally, you will need to install the Python dependencies. To do that, type the following commands:
 
-```
+```bash
 git clone https://github.com/ReproNim/reproschema.git
 cd reproschema
 pip install -r requirements.txt
@@ -20,7 +23,7 @@ by `git clone [email protected]/<username>/reproschema.git` where `<username>` is y
 
 Once done, you need to run MkDocs. Simply type:
 
-```
+```bash
 mkdocs serve
 ```