ENH fix typos, use named tuples, some more docs