revised documentation format