doc: polish theming docs

close issue #651