formatting of docs to prevent failures