mostly documentation
reformatted documentation (markdown style)