Add readme, better help docstrings and better debug comments.