api: Restructured file format in line with good practice.

Signed-off-by: Joe MacMahon <joe.macmahon@cern.ch>
docs: Restructured documentation to simplify and reflect code.

Signed-off-by: Joe MacMahon <joe.macmahon@cern.ch>
doc: Updated README

* Added info about testing.

Signed-off-by: Joe MacMahon <joe.macmahon@cern.ch>
docs: Added RTD link to README

Signed-off-by: Joe MacMahon <joe.macmahon@cern.ch>