updated documentation for the final few methods