Fix doc-related things (#51)

- Fix version number of documentation
- Add `-b linkcheck` to `make html`
- Expand the "history" within the changelog
- Add links to Swung and the Swung-Slack

Author: prisae

.github/workflows/docs.yml

@@ -2,7 +2,7 @@ name: docs
 
 # Controls when the action will run.
 on:
-  # Triggers the workflow on push or pull request events but only for the master branch
+  # Triggers the workflow on push or pull request events but only for main
   push:
     branches:
         - main
@@ -16,6 +16,8 @@ on:
 jobs:
   docs:
 
+    name: Deploy docs
+
     runs-on: ubuntu-latest
 
     env:
@@ -25,7 +27,23 @@ jobs:
       SHELLOPTS: 'errexit:pipefail'
 
     steps:
-      - uses: actions/checkout@v2
+      # Checks-out your repository under $GITHUB_WORKSPACE
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          # Need to fetch more than the last commit so that setuptools_scm can
+          # create the correct version string. If the number of commits since
+          # the last release is greater than this, the version will still be
+          # wrong. Increase if necessary.
+          fetch-depth: 100
+          # The GitHub token is preserved by default but this job doesn't need
+          # to be able to push to GitHub.
+          persist-credentials: false
+
+      # Need the tags so that setuptools_scm can form a valid version number
+      - name: Fetch git tags
+        run: git fetch origin 'refs/tags/*:refs/tags/*'
+
       - name: Setup Headless Display
         run: |
           sudo apt-get install libgl1-mesa-glx
@@ -44,9 +62,9 @@ jobs:
           pip install -r requirements_dev.txt
           pip install -e .
 
-      - name: Generate Sphinx Docs
+      - name: Generate Docs & Check Links
         working-directory: docs/
-        run: make html
+        run: make html -b linkcheck
 
       - name: Publish generated content to GitHub Pages
         uses: tsunematsu21/[email protected]

CHANGELOG.rst

@@ -2,25 +2,40 @@ Changelog
 #########
 
 
+v0.x-series
+===========
+
 v0.2.3
 ------
 
 First automatic deploy to PyPI and conda-forge.
 
 
+
+History
+=======
+
+
 April 2021
 ----------
 
-Transform 2021; geo-stack packages start to support subsurface.
+**Transform2021:** `#t21-hack-subsurface` builds on the work done by @Leguark
+during the time since Transform2020. First geo-stack packages start to support
+subsurface: GemPy, pyGIMLi, segysak, verde (Fatiando), discretize (SimPEG),
+PyVista, welly, striplog.
 
 
 June 2020
 ---------
 
-Transform2020; reviving it.
+**Transform2020:** `#t20-hack-gostin` revives the idea with contributions from
+many people of the SWUNG community, representing also many geo-stack
+communities (GemPy, PyVista, Fatiando, SimPEG, pyGIMLi, map2loop, OMF, geoh5py,
+and more).
 
 
 May 2019
 --------
 
-Transform2019; and idea is born.
+**Transform2019:** An idea is born at The Château in France (@kwinkunks,
+@JesperDramsch, @alex-schaaf).

docs/source/conf.py

@@ -138,6 +138,10 @@
 html_context = {
     'menu_links_name': 'Links',
     'menu_links': [
+        ('<i class="fa fa-link fa-fw"></i> SWUNG',
+         'https://softwareunderground.org'),
+        ('<i class="fa fa-slack fa-fw"></i> Slack',
+         'https://swu.ng/slack'),
         ('<i class="fa fa-github fa-fw"></i> Source Code',
          'https://github.com/softwareunderground/subsurface'),
     ],