From: Ben Sturmfels <ben@sturm.com.au>
Date: Tue, 28 Apr 2020 03:36:48 +0000 (+1000)
Subject: Fix Sphinx build warnings, remove gNewSense, *buntu -> Ubuntu.
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=4e28403812dcc7f5fad984bd221e3d66546d47e7;p=mediagoblin.git

Fix Sphinx build warnings, remove gNewSense, *buntu -> Ubuntu.

The * feels like it might confuse no-programmers.
---

diff --git a/docs/source/siteadmin/deploying.rst b/docs/source/siteadmin/deploying.rst
index d5a7fe69..c91912af 100644
--- a/docs/source/siteadmin/deploying.rst
+++ b/docs/source/siteadmin/deploying.rst
@@ -65,7 +65,7 @@ MediaGoblin has the following core dependencies:
 - `virtualenv <http://www.virtualenv.org/>`_
 - `nodejs <https://nodejs.org>`_
 
-On a DEB-based system (e.g Debian, gNewSense, Trisquel, \*buntu, and
+On a DEB-based system (e.g Debian, gNewSense, Trisquel, Ubuntu, and
 derivatives) issue the following command::
 
     sudo apt-get install git-core python python3-dev python3-lxml \
@@ -344,7 +344,7 @@ exit to return to the root/sudo account.::
 
 
 Waitress and nginx
-~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~
 
 This configuration example will use Nginx, however, you may
 use any webserver of your choice. If you do not already have
@@ -357,8 +357,8 @@ into a directory that will be included in your ``nginx`` configuration
 (e.g. "``/etc/nginx/sites-enabled`` or ``/etc/nginx/conf.d``) with
 one of the following commands.
 
-On a DEB-based system (e.g Debian, gNewSense, Trisquel, *buntu, and
-derivatives) issue the following commands::
+On a DEB-based system (e.g Debian, Trisquel, Ubuntu and derivatives)
+issue the following commands::
 
     sudo ln -s /srv/mediagoblin.example.org/nginx.conf /etc/nginx/sites-enabled/
     sudo systemctl enable nginx
diff --git a/docs/source/siteadmin/production-deployments.rst b/docs/source/siteadmin/production-deployments.rst
index 01794cdf..681a3cda 100644
--- a/docs/source/siteadmin/production-deployments.rst
+++ b/docs/source/siteadmin/production-deployments.rst
@@ -58,7 +58,7 @@ modify it to suit your environment's setup:
 .. code-block:: bash
 
     # Set the WorkingDirectory, Environment and ExecStart values to match your environment.
-    # If using Debian/*buntu, mkdir and chown are located in /bin/mkdir and /bin/chown, respectively.
+    # If using Debian/Ubuntu, mkdir and chown are located in /bin/mkdir and /bin/chown, respectively.
     # If using Fedora/CentOS/Red Hat, mkdir and chown are located in /usr/bin/mkdir and /usr/bin/chown, respectively.
 
     [Unit]
diff --git a/docs/source/siteadmin/relnotes.rst b/docs/source/siteadmin/relnotes.rst
index 55dd9cdf..82280a3d 100644
--- a/docs/source/siteadmin/relnotes.rst
+++ b/docs/source/siteadmin/relnotes.rst
@@ -40,7 +40,7 @@ carefully, or at least skim over it.
 
 
 0.10.0 (work in progress)
-======
+=========================
 
 
 **Do this to upgrade**
@@ -96,6 +96,7 @@ Python 3, which is pretty cool!
 - Python 3 is now a first class citizen!  We now support both
   Python 2.7 and Python 3.4 or later.
 - Major updates to internal tooling to pave the way for federation.
+
   - Massive overhaul to the database layout (particularly in
     permitting generic relations)
   - OAuth updates
@@ -104,6 +105,7 @@ Python 3, which is pretty cool!
     about removed objects
   - Large overhaul to how "comments" work.  In federation, many things
     can reply to many things, so we had to loosen the model.
+
 - If your user has some collections available, these will be presented
   as a dropdown option while submitting media.
 - Begin using Alembic for migrations
@@ -209,8 +211,10 @@ Additionally:
 - Preliminary / experimental support for Python 3!
 - Footer forced to the bottom of page
 - Massive improvements to Pump API support
+
   - Able to run on multiple existing Pump clients!  Including Pumpa
     and Dianara!
+
 - much cleaner ./configure && make support; it's now the default
 - Clearer documentation on permissions and installation
 - Switched from Transifex, which had become proprietary, to an
@@ -418,6 +422,7 @@ nickname "Lore of the Admin"!
   document to set up your own.
 
 - We have a lot of new administrative tooling features!
+
   - There's a built-in privileges/permissions system now.
     Administrators are given access to modifying these parameters
     from a user administration panel.