improving documentation, reverting changes in commented out tests