hard clip all documentation to adhere to the conventions