updated documentation in markdown