more docs, some changes