Add install/update instructions database (#1160)

* Add install/update instructions database

* Update the database

* Revert README changes

They will be overwritten later.

* Revert

* Tweak

* Tweaks

* Upgrade database

* Complete commands

Still not sure about Spack upgrades.

* Sort

* Doc generation script draft

* Remove OS names from tool names

* Fix Linuxbrew name

* `wheel` already installs `setuptools`

* Gen docs

* Update

* Tweak

* Add a GitHub workflow to check for outdated installation instructions

* Fix return value

* Test

* Delete test

* Rename the script

* Add `make doc-install-inst`

* Add missing dev requirement

* The first tool is the primary we want to display

Then they are simply sorted by `tool.title`.

* Sort OSes by name

* Refactoring, jinja template, etc.

* Add tool title uniqueness `assert`, fix platform list extra `\n`

* Rebuild docs

* Update generate.py

* Update README.md

* Update methods.yml

* Update distros derived, more assertions

* Tweaks

* Add workflow to auto-update the docs

* Do not hide the command

* Tweaks

Co-authored-by: Jakub Roztocil <jakub@roztocil.co>

.github/workflows/code-style.yml

@@ -1,5 +1,3 @@
-name: Code style
-
 on:
   pull_request:
     paths:

.github/workflows/coverage.yml

@@ -1,5 +1,3 @@
-name: Coverage
-
 on:
   pull_request:
     paths:

.github/workflows/docs-check-markdown.yml

@@ -1,5 +1,3 @@
-name: Check markdown
-
 on:
   pull_request:
     paths:

.github/workflows/docs-deploy.yml

@@ -1,5 +1,3 @@
-name: Update documentation
-
 on:
   push:
     branches:

.github/workflows/docs-update-install.yml

@@ -0,0 +1,26 @@
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - docs/installation/*
+
+  # Allow to call the workflow manually
+  workflow_dispatch:
+
+jobs:
+  doc:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
+        with:
+          python-version: 3.9
+      - run: make install
+      - run: make doc-update-install
+      - uses: Automattic/action-commit-to-branch@master
+        with:
+          branch: master
+          commit_message: Auto-update installation instructions in the docs
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -1,5 +1,3 @@
-name: Release
-
 on:
   # Add a "Trigger" button to manually start the workflow.
   workflow_dispatch:

.github/workflows/test-package-linux-snap.yml

@@ -1,5 +1,3 @@
-name: Linux snap
-
 on:
   pull_request:
     paths:

.github/workflows/tests.yml

@@ -1,5 +1,3 @@
-name: Tests
-
 on:
   push:
     branches: