better doc strings and fixed some typos