updated examples and docstrings, added incomelevel service