documentation format improvements