improve docs for first release