fixed api documentation formatting, added tests note