adds some user interface action
refactors the doc