improved documentation of test format (+formatting fixes)