following most of the documentation style conventions i want