From 1d41adb346262f19618dbb8604320b7fe1a8d302 Mon Sep 17 00:00:00 2001
From: David Wilson <dw@botanicus.net>
Date: Sun, 11 Aug 2019 15:33:42 +0100
Subject: [PATCH] docs: tweaks

---
 docs/ansible_detailed.rst |  3 +--
 docs/changelog.rst        | 16 +++++++++-------
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/docs/ansible_detailed.rst b/docs/ansible_detailed.rst
index 4e8dcd27..c3bbad59 100644
--- a/docs/ansible_detailed.rst
+++ b/docs/ansible_detailed.rst
@@ -82,8 +82,7 @@ Installation
     <form action="https://networkgenomics.com/save-email/" method="post" id="emailform">
         <input type=hidden name="list_name" value="mitogen-announce">
 
-        Releases occur frequently and often include important fixes. Subscribe
-        to the mitogen-announce list to stay updated.
+        Get notified of new releases and important fixes.
 
         <p>
         <input type="email" placeholder="E-mail Address" name="email" style="font-size: 105%;">
diff --git a/docs/changelog.rst b/docs/changelog.rst
index 39d6a46c..37cab2e3 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -72,18 +72,20 @@ Mitogen for Ansible
   detected, to work around a broken heuristic in popular SELinux policies that
   prevents inheriting ``AF_UNIX`` sockets across privilege domains.
 
-* `#467 <https://github.com/dw/mitogen/issues/467>`_: an incompatibility
+* `#467 <httpe://github.com/dw/mitogen/issues/467>`_: an incompatibility
   running Mitogen under Molecule was resolved.
 
 * `#547 <https://github.com/dw/mitogen/issues/547>`_,
   `#598 <https://github.com/dw/mitogen/issues/598>`_: fix a serious deadlock
-  possible during initialization of any task executed by forking, such as
-  ``async`` tasks, tasks using custom :mod:`ansible.module_utils`,
+  possible while initializing the service pool of any child, such as during
+  connection, ``async`` tasks, tasks using custom :mod:`module_utils`,
   ``mitogen_task_isolation: fork`` modules, and those present on an internal
-  blacklist of misbehaving modules. This deadlock is relatively easy hit, has
-  been present since 0.2.0, and is likely to have impacted many users. For new
-  connections it could manifest as a *Connection timed out* error, for forked
-  tasks it could manifest as a timeout or an apparent hang.
+  blacklist of misbehaving modules.
+
+  This deadlock is relatively easy hit, has been present since 0.2.0, and is
+  likely to have impacted many users. For new connections it could manifest as
+  a *Connection timed out* error, for forked tasks it could manifest as a
+  timeout or an apparent hang.
 
 * `#549 <https://github.com/dw/mitogen/issues/549>`_: the open file descriptor
   limit for the Ansible process is increased to the available hard limit. It is