add more docs, and report