updates to documentation
finish a rewrite of documentation for 4 main map functions. add examples to said functions