doc(selector): improve api doc

Closes #1038