diff --git a/roles/kiwix/README.rst b/roles/kiwix/README.rst
index 0a6aa1741..64c73aaa6 100644
--- a/roles/kiwix/README.rst
+++ b/roles/kiwix/README.rst
@@ -3,21 +3,21 @@ Kiwix README
 ============
 
 Kiwix develops ZIM file creation & rendering tools for offline action,
-as summarized at: http://wiki.kiwix.org/wiki/Software
+as summarized at: https://wiki.kiwix.org/wiki/Software
 
-Internet-in-a-Box uses the kiwix-serve and kiwix-manage executables (in
-/opt/iiab/kiwix/bin) to set up and render ZIM files such as Wikipedia, and
-other educational materials: http://download.kiwix.org/zim/
+Internet-in-a-Box uses executables like kiwix-manage, kiwix-serve and kiwix-search (in
+``/opt/iiab/kiwix/bin``) to set up and render ZIM files (such as Wikipedia, and
+other educational materials) typically from https://download.kiwix.org/zim/
 
 Locations
 ---------
 
-- Your ZIM files go in /library/zims/content
-- Your ZIM index files go in directories under /library/zims/index (these index files are increasingly no longer necessary, as most ZIM files produced since 2017 contain an internal search index instead!)
+- Your ZIM files go in ``/library/zims/content``
+- Your ZIM index files used to go in directories under ``/library/zims/index`` (these index files are increasingly no longer necessary, as most ZIM files produced since 2017 contain an internal search index instead!)
 - The URL is http://box/kiwix or http://box.lan/kiwix (both proxied for AWStats)
-- Use URL http://box:3000/kiwix/ if you want to avoid the proxy
+- Use URL http://box:3000/kiwix if you want to avoid the proxy
 
-Your local ZIM catalog (at /library/zims/library.xml) can be regenerated by running:
-/usr/bin/iiab-make-kiwix-lib
+Your ``/library/zims/library.xml`` (containing essential metadata for the ZIM files you've installed) can be regenerated if necessary, by running:
+``/usr/bin/iiab-make-kiwix-lib``
 
-See "How do I add ZIM files, like Wikipedia?" at http://FAQ.IIAB.IO
+See also "How do I add ZIM files, like Wikipedia?" at http://FAQ.IIAB.IO