Improve API docs a bit
Summary: Some typos and make some sentences easier to read
Reviewers: Plasma, dhaumann, apol
Reviewed By: dhaumann, apol
Subscribers: dhaumann, kde-frameworks-devel
Tags: Frameworks
Differential Revision: https://phabricator.kde.org/D14240