some fixes suggested by david

Author: hjwp

chapter_09_docker.asciidoc

@@ -1479,4 +1479,8 @@ Some typical pain points--networking, ports, static files, and the database::
     and some configuration issues like static files.
 
 
+// TODO: add debugging tips docker ps, docker inspect, docker logs.
+// also brief description of network debugging:  try curl outside, try curl inside, restart pc / docker /colima
+// also maybe the lsof command to see who's using what port
+
 *******************************************************************************

chapter_11_ansible.asciidoc

@@ -306,7 +306,7 @@ for.
 
     - name: Install docker  #<1>
       ansible.builtin.apt:  #<2>
-        name: docker  #<3>
+        name: docker.io  #<3>
         state: latest
         update_cache: true
       become: true
@@ -331,7 +331,9 @@ for.
   around the `apt` Debian & Ubuntu package management tool.
 
 <3> Each module then provides a bunch of parameters which control how it works.
-    Here we specify the `name` of the package we want to install ("docker")
+    Here we specify the `name` of the package we want to install ("docker.io"footnote:[
+    In the official docker installation instructions, you'll see a recommendation to install docker via a private package repository.
+    I wanted to avoid that complexity for the book, but you should probably follow those instructions in a real-world scenario.])
     and tell it to update its cache first, which is required on a fresh server.
 
 Most Ansible modules have pretty good documentation,
@@ -340,6 +342,7 @@ I often skip to the
 https://docs.ansible.com/ansible/latest/collections/ansible/builtin/apt_module.html#examples[Examples section].
 
 // RITA: Please add a sentence or two to introduce the following code block.
+
 [subs="specialcharacters,quotes"]
 ----
 $ *ansible-playbook --user=elspeth -i staging.ottg.co.uk, infra/ansible-provision.yaml -vv*
@@ -392,6 +395,9 @@ computer Mother, in _Alien_.
 Ansible scripts are particularly satisfying in this regard.
 
 
+TIP: You may need to use the `--ask-become-pass` argument to `ansible-playbook`
+    if you get an error "Missing sudo password".
+
 
 === SSHing Into the Server and Viewing Container Logs
 
@@ -472,7 +478,7 @@ In Ansible config, it looks like this:
   tasks:
     - name: Install docker
       ansible.builtin.apt:
-        name: docker
+        name: docker.io
         state: latest
       become: true
 
@@ -1000,7 +1006,8 @@ and reloads it automatically if it crashes.
 *******************************************************************************
 
 A few more places to look and things to try, now that we've introduced
-Docker into the mix, should things not go according to plan:
+Docker into the mix, should things not go according to plan--all of these
+should be run on the server, inside an SSH session:
 
 - You can check the Container logs using
   `docker logs superlists`.