From ce6c5c507dbe81c24da78b28ebb2e485073e1315 Mon Sep 17 00:00:00 2001
From: A Holt <holta@users.noreply.github.com>
Date: Wed, 28 Jul 2021 03:02:23 -0400
Subject: [PATCH] Update 2-common/README.rst

---
 roles/2-common/README.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

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