more work on documentation