From: nicoo <nicoo@realraum.at>
Date: Mon, 2 Jul 2018 21:20:15 +0000 (+0200)
Subject: doc/Network: Document VLAN conventions
X-Git-Url: https://git.realraum.at/?a=commitdiff_plain;h=6f38d747407e51ba8819026e2fffeba8fc259180;p=noc.git

doc/Network: Document VLAN conventions
---

diff --git a/doc/Network.mdwn b/doc/Network.mdwn
index 7705f41..ced1937 100644
--- a/doc/Network.mdwn
+++ b/doc/Network.mdwn
@@ -8,6 +8,16 @@ NOC runs 2 core switches (one in each room), carrying a bunch of VLANs:
 - 255 (`0xFF`) is our Funkfeuer VLAN.
 
 
+### Conventions
+
+We use a number of conventions to make things more consistent:
+
+- The DNS zone for a given network is `NET.realraum.at`, with the exception
+  of the public services network (which has `realraum.at`);
+- Networks using RFC 1918 IP space use the 192.168.VID.0/24 subnet;
+- The gateway for a network is on the last IP for the subnet.
+
+
 
 ## WiFi