massive improvement on class documentation

- added example code for application components
- added missing short description

[ci skip]