Improve datahandling documentation

The documentation overall should be improved. Borrowing from Midas, we can make a low-hanging fruit improvement in the datahandling as a first step.