Merge pull request #3054 from iiab/adoc-test

Test 'pandoc README.rst -o README.adoc' [AsciiDoc] in 1-prep & 2-common

roles/1-prep/README.adoc

@@ -0,0 +1,31 @@
+== 1-prep README
+
+This 1st
+https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible[stage]
+(1-prep) arranges low-level things like remote support infra, DNS prep,
+hardware, low-level OS quirks, and basic security:
+
+* SSHD
+* OpenVPN if/as needed later for remote support
+* https://github.com/iiab/iiab/tree/master/roles/iiab-admin#iiab-admin-readme[iiab-admin]
+username and group, to log into Admin Console
+* dnsmasq (install now, configure later!)
+* Universally unique identifier: /etc/iiab/uuid
+* Ubermix (distro) needs /etc/tmpfiles.d/iiab.conf to create essential
+/var/log subdirs on each boot
+* *_Hardware actions:_*
+  ** link:tasks/raspberry_pi.yml[*_raspberry_pi.yml_*]:
+    *** RTC (real-time clock): install udev rule, configure, enable
+    *** *_Install packages related to:_*
+      **** growpart
+      **** swapfile
+      **** fake-hwclock (as RTC is often missing or dead!)
+      **** Wi-Fi
+    *** Increase swap file size
+    *** https://github.com/iiab/iiab/blob/master/roles/1-prep/templates/iiab-rpi-max-rootfs.sh[rootfs
+    auto-resizing]
+  ** NUC 6 Wi-Fi firmware
+
+Recap: Similar to 0-init, 2-common, 3-base-server, 4 server-options and
+5-xo-services — this 1st stage installs core server infra (that is not
+user-facing).

roles/2-common/README.adoc

@@ -0,0 +1,21 @@
+== 2-common README
+
+This 2nd
+https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible[stage]
+is for OS-level basics _common_ to all platforms, i.e. core
+prerequisites to building up a functioning
+https://internet-in-a-box.org/[Internet-in-a-Box (IIAB)] server.
+
+These are (partially) put in place:
+
+* IIAB directory structure (link:tasks/fl.yml[file layout])
+* Common https://en.wikipedia.org/wiki/APT_(software)[apt] software
+packages
+* Networking (including the
+https://en.wikipedia.org/wiki/Iptables[iptables] firewall)
+* link:tasks/iiab-startup.yml[/usr/libexec/iiab-startup.sh] similar to
+AUTOEXEC.BAT and /etc/rc.local, in order to run jobs on boot
+
+Recap: As with 0-init, 1-prep, 3-base-server, 4-server-options and
+5-xo-services — this 2nd stage installs core server infra (that is not
+user-facing).