make the documentation more user friendly