Improve apidox

Summary:
Stress the fact that a misconfigured appname/component name
will result in notifications not working.
While at it, fix a bunch of minor typos.

Reviewers: mck182

Subscribers: Frameworks

Tags: Frameworks

Differential Revision: https://phabricator.kde.org/D5718