Add and improve user scripting api docs from 2.9
Summary: Add docs from 2.9 and improve
Test Plan: Const and comment changes only
Reviewers: staniek
Reviewed By: staniek
Tags: KReport
Maniphest Tasks: T1744
Differential Revision: https://phabricator.kde.org/D5894