commit: more doc nits

README.md

@@ -87,28 +87,11 @@ In production, of course, one would expect to use an SSL EV
 certificate to provide identity and assurance to an onion site,
 rendering these issues moot.
 
-
 ## Installation
 
 Please refer to the [How To Install](docs.d/HOW-TO-INSTALL.md) guide
 
-## Video Demonstrations
-
-**These videos are instructive, but dated.**
-
-Commands have changed - but not very much - but please check the
-documentation rather than trust the videos; consider the videos to be
-advisory rather than correct.
-
-* [Basic Introduction to EOTK](https://www.youtube.com/watch?v=ti_VkVmE3J4)
-* [Rough Edges: SSL Certificates & Strange Behaviour](https://www.youtube.com/watch?v=UieLTllLPlQ)
-* [Using OnionBalance](https://www.youtube.com/watch?v=HNJaMNVCb-U)
-
-[![Basic Introduction to EOTK](http://img.youtube.com/vi/ti_VkVmE3J4/0.jpg)](http://www.youtube.com/watch?v=ti_VkVmE3J4)
-[![Rough Edges: SSL Certificates & Strange Behaviour](http://img.youtube.com/vi/UieLTllLPlQ/0.jpg)](http://www.youtube.com/watch?v=UieLTllLPlQ)
-[![Using OnionBalance](http://img.youtube.com/vi/HNJaMNVCb-U/0.jpg)](http://www.youtube.com/watch?v=HNJaMNVCb-U)
-
-### Help I'm Stuck!
+## Help I'm Stuck!
 
 Ping @alecmuffett on Twitter, or log an `Issue`, above.
 
@@ -131,32 +114,3 @@ Also, thanks go to Christopher Weatherhead for acting as a local NGINX
 
 And back in history: Michal Nánási, Matt Jones, Trevor Pottinger and
 the rest of the FB-over-Tor team.  Hugs.
-
-## Architectures
-
-### hardmap 1
-
-![hardmap 1](docs.d/hardmap-1.png)
-
-### hardmap 2
-
-![hardmap 2](docs.d/hardmap-2.png)
-
-### softmap 1
-
-![softmap 1](docs.d/softmap-1.png)
-
-### softmap 2
-
-![softmap 2](docs.d/softmap-2.png)
-
-### softmap 3
-
-![softmap 3](docs.d/softmap-3.png)
-
-### softmap 4
-
-![softmap 4](docs.d/softmap-4.png)
-
-----
-*eotk (c) 2017 Alec Muffett*

docs.d/ARCHITECTURES.md

@@ -0,0 +1,28 @@
+# Architectures
+
+## hardmap 1
+
+![hardmap 1](docs.d/hardmap-1.png)
+
+## hardmap 2
+
+![hardmap 2](docs.d/hardmap-2.png)
+
+## softmap 1
+
+![softmap 1](docs.d/softmap-1.png)
+
+## softmap 2
+
+![softmap 2](docs.d/softmap-2.png)
+
+## softmap 3
+
+![softmap 3](docs.d/softmap-3.png)
+
+## softmap 4
+
+![softmap 4](docs.d/softmap-4.png)
+
+----
+*eotk (c) 2017 Alec Muffett*

docs.d/HOW-TO-INSTALL.md

@@ -1,16 +1,4 @@
-# Requirements
-
-EOTK requires recent `nginx` with the following modules/features enabled:
-
-* `headers_more`
-* `ngx_http_substitutions_filter_module`
-* `http_sub`
-* `http_ssl`
-* Lua and/or LuaJIT (ideally from OpenResty)
-
-# Installation
-
-Per-platform:
+# Per-platform Installation
 
 ## Ubuntu 18.04LTS (prebuilt via tor and canonical)
 
@@ -41,6 +29,18 @@ into Raspbian; scripts are supplied for Raspbian "Stretch".
 * `./opt.d/build-tor-on-raspbian-stretch.sh`
 * `./opt.d/install-onionbalance-on-raspbian-stretch.sh`
 
+## Other Platform Outline Requirements
+
+EOTK requires recent `tor` and also `nginx` with the following modules
+enabled; EOTK may need to be told about the modules via
+`set nginx_modules_dirs ...`
+
+* `headers_more`
+* `ngx_http_substitutions_filter_module`
+* `http_sub`
+* `http_ssl`
+* Lua and/or LuaJIT (ideally from OpenResty)
+
 # Dealing With OnionBalance And Load-Balancing
 
 *NEW FOR 2019:*
@@ -83,7 +83,9 @@ Please read the individual files for installation instructions; local
 setup is intended to be pretty simple, let me know if anything is
 confusing.
 
+----
 # LEGACY DOCUMENTATION IN NEED OF REVIEW, BELOW THIS POINT
+----
 
 ## I Want To Create My Own Project!
 
@@ -297,3 +299,19 @@ persists, check the logfiles.
 Is the clock/time of day correct on all your machines?  Are you
 running NTP?  We are not sure but having an incorrect clock may be a
 contributory factor to this issue.
+
+## Video Demonstrations
+
+**These videos are instructive, but dated.**
+
+Commands have changed - but not very much - but please check the
+documentation rather than trust the videos; consider the videos to be
+advisory rather than correct.
+
+* [Basic Introduction to EOTK](https://www.youtube.com/watch?v=ti_VkVmE3J4)
+* [Rough Edges: SSL Certificates & Strange Behaviour](https://www.youtube.com/watch?v=UieLTllLPlQ)
+* [Using OnionBalance](https://www.youtube.com/watch?v=HNJaMNVCb-U)
+
+[![Basic Introduction to EOTK](http://img.youtube.com/vi/ti_VkVmE3J4/0.jpg)](http://www.youtube.com/watch?v=ti_VkVmE3J4)
+[![Rough Edges: SSL Certificates & Strange Behaviour](http://img.youtube.com/vi/UieLTllLPlQ/0.jpg)](http://www.youtube.com/watch?v=UieLTllLPlQ)
+[![Using OnionBalance](http://img.youtube.com/vi/HNJaMNVCb-U/0.jpg)](http://www.youtube.com/watch?v=HNJaMNVCb-U)