clarifications after dev list discussion, benchmark updates, and usage examples.