Merge pull request #25 from szymon-rd/scaladoc-fixes-ux-fixes

implementing ux changes and fixes

Author: kamilszewczyk0