add usability docstring
move copy from core to usability