One year update for documentation

2 files changed, 48 insertions, 25 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..302ea00
--- /dev/null
+++ b/README
@@ -0,0 +1,48 @@
+rgoncalves.se ~~ ansible
+========================
+
+naming scheme
+-------------
+
+- ws: workstation
+- dc:  domain controller
+- st:  stack server
+- sw:  switch
+- rt:  router
+- vm:  virtual machine
+
+
+example:
+
+- stack0: first stack server, hosting vm and/or bare-metal os
+- dcontroller 
+
+
+inventory
+---------
+
+workstations:
+
+- ws-bentonite		static workstation and custom build
+- ws-think01		thinkpad x220 w/ openbsd  
+- ws-xps01		dell xps w/ archlinux
+
+servers:
+
+- dcontroller		domain controller
+- stack0		freebsd virtualization R720
+- stack1		openbsd fileserver/monitoring X4170
+
+- vm0			gaming server
+- vm1			grafana server
+- vm2			openbsd (devel) git/trash server
+
+todo
+----
+
+- rename dc01
+- rename st0-games
+- create st0-development
+- create st0-lineage
+- create st1-development
+- rename st1-monitoring
diff --git a/README.md b/README.md
deleted file mode 100644
index 44f72e6..0000000
--- a/README.md
+++ /dev/null
@@ -1,25 +0,0 @@
-## preambule
-
-Ansible playbooks and roles for managing infrastructure at `<rgoncalves.se>`.
-
-## usage
-
-Generate a global playbook with all sub-roles.
-
-```bash
-./generate_all
-```
-
-Execute a role on a desired host or set of hosts.
-
-```bash
-ansible-playbook play-all.yml --tags "<desired_role>" --l "<desired host or host-pattern>"
-```
-
-## examples
-
-Update system and install utility on my primary physical server `OOP-DV-stack0`.
-
-```bash
-ansible-playbook play-all.yml --tags "update,setup_utils" -l "*stack0"
-```