Reorganize doumentation

docs/source/about.rst

@@ -60,7 +60,7 @@ State-transition diagram for DHCP clients:
 Current status
 --------------
 
-WIP, still not recommended for end users.
+Minimal version implemented, still to be improved.
 
 See :ref:`todo`
 
@@ -72,12 +72,20 @@ See :ref:`install`
 Download
 --------
 
-You can download this project in either
-`zip <http://github.com/juga0/dhcpcanon/zipball/master()>`__
-or `tar <http://github.com/juga0/dhcpcanon/tarball/master>`__ formats.
+See :ref:`download`
 
-You can also clone the project with Git by running:
-    git clone git://github.com/juga0/dhcpcanon
+Developers documentation
+--------------------------
+
+:ref:`api`
+
+:ref:`integration`
+
+:ref:`rfcs`
+
+:ref:`tech`
+
+:ref:`rfc7844comm`
 
 Bugs and features
 -----------------

docs/source/api.rst

@@ -0,0 +1,4 @@
+.. _api:
+
+API
+=====

docs/source/download.rst

@@ -0,0 +1,11 @@
+.. _download:
+
+Download dhcpcanon
+===================
+
+You can download this project in either
+`zip <http://github.com/juga0/dhcpcanon/zipball/master()>`__
+or `tar <http://github.com/juga0/dhcpcanon/tarball/master>`__ formats.
+
+You can also clone the project with Git by running:
+    git clone git://github.com/juga0/dhcpcanon

docs/source/install.rst

@@ -3,6 +3,11 @@
 Install dhcpcanon
 =================
 
+Installation in Debian testing
+-------------------------------
+
+    sudo apt install dhcpcanon
+
 Installation in Debian/Ubuntu from source code
 ----------------------------------------------
 
@@ -11,7 +16,7 @@ Install system dependencies
 
 ::
 
-    sudo apt-get install python-dev
+    sudo apt install python-dev
 
 Install dhcpcanon dependencies with virtualenv
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -23,7 +28,7 @@ Check https://virtualenv.pypa.io/en/latest/installation.html or
 if Debian equal/newer than Jessie (virtualenv version equal or greater
 than 1.9), then:
 
-    sudo apt-get install python-virtualenv
+    sudo apt install python-virtualenv
 
 Create a virtual environment
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -41,4 +46,4 @@ Install dependencies in virtualenv
 or run:
     python setup.py install
 or run:
-    pip install dhcpcanon
+    pip install dhcpcanon

docs/source/integration.rst

@@ -1,3 +1,5 @@
+.. _integration:
+
 Integration
 =============
 

docs/source/rfcs.rst

@@ -1,20 +1,18 @@
 .. _rfcs:
 
-=============
-DHCP RFCs
-============
+Relevant RFCs
+=====================
 
-IETF DHC Working Group
-=========================
+- `privacy related RFCs repository <https://github.com/juga0/privacy>`__
+- DHCP Anonymity Profile `RFC7844 <https://tools.ietf.org/html/rfc7844>`__
+- DHCP standard `Dynamic Host Configuration Protocol <https://tools.ietf.org/html/rfc2131>`__
+- `Node-specific Client Identifiers for Dynamic Host Configuration Protcol Version Four (DHCPv4) <https://tools.ietf.org/html/rfc4361>`__
 
-`privacy related RFCs repo <https://github.com/juga0/privacy>`__
+IETF DHC Working Group maling list
+===================================
 
-DHCP Anonymity Profile `RFC7844 <https://tools.ietf.org/html/rfc7844>`__
+relevant messages discussing RFC7844:
 
-`Searchable dhcwg maling list <https://mailarchive.ietf.org/arch/search/?email_list=dhcwg`__
-
-`dhcwg maling list anonymity profiles filtered <https://mailarchive.ietf.org/arch/search/?email_list=dhcwg&q=anonymity+profiles+for+dhcp+clients>`__
-
-`dhcwg maling list anonymity profiles filtered mbox <https://mailarchive.ietf.org/arch/export/mbox/?email_list=dhcwg&q=anonymity+profiles+for+dhcp+clients>`__
-
-DHCP standard `Dynamic Host Configuration Protocol <https://tools.ietf.org/html/rfc2131>`__
+- `Searchable dhcwg maling list <https://mailarchive.ietf.org/arch/search/?email_list=dhcwg`__
+- `dhcwg maling list anonymity profiles filtered <https://mailarchive.ietf.org/arch/search/?email_list=dhcwg&q=anonymity+profiles+for+dhcp+clients>`__
+- `dhcwg maling list anonymity profiles filtered mbox <https://mailarchive.ietf.org/arch/export/mbox/?email_list=dhcwg&q=anonymity+profiles+for+dhcp+clients>`__

docs/source/tech.rst

@@ -1,3 +1,5 @@
+.. _tech:
+
 RFC7844 implementation considerations
 ==========================================
 
@@ -10,7 +12,7 @@ tools implement already the standard.
 This is intended to be an example of the anonymity profiles implementation.
 
 ``SHOULD`` options
-----------------
+--------------------
 
 Leases
 -------