update documentation on dictionaries