added the documentation for the refresh and find methods to be implemented
adding the dict return