Improve network documentation

docs/network.rst

@@ -5,11 +5,31 @@ Network
 
 CSEntry allows to register networks and hosts.
 
+A **network scope** defines a range of VLAN and a supernet where **networks** can be assigned.
+A **host** can be a physical or virtual machine. It includes one or more **interfaces**.
+
+
 .. image:: _static/network.png
 
-Clicking on an **hostname** item will take you to the *View host* page.
+Clicking on an **hostname** will take you to the *View host* page.
 
 .. image:: _static/view_host.png
 
 On that page you can see all the host's details.
 You can add extra interfaces, edit the existing interfaces or edit the host information.
+
+To register a new host, you should:
+
+   1. Enter a hostname.
+   2. Choose a Type. For physical machines, you can associate an **item** from the inventory (optional).
+   3. Enter a description (optional).
+   4. Choose the network for the primary interface. The first available IP address on that network is automatically filled.
+      You should not modify it except if you have a specific reason.
+   5. For physical machines, you have to enter the MAC address. A random one is automatically generated for virtual machines.
+   6. Click Submit.
+
+.. image:: _static/register_host.png
+
+If you need more than one interface, you should go to the *Add interface* pane from the *View host* page.
+
+.. image:: _static/add_interface.png