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>