making documentation useful