update(docs): improved button jsdocs

Close #675. Thx @SanderElias.