more documentation & typos