more additions, more documentation