WIP-Improved documentation

* Improves documentation by re-arranging its structure and
  introducing full discussion about performance merit of
  intbitset.

Signed-off-by: Samuele Kaplun <samuele.kaplun@cern.ch>
Please add also a note that if you change Python version, you may need to redo serialisation... t