Add some documentation for PlatformDependent

Summary:
Also add note about deprecating askForCredentials and saveCredentials in
future.

Reviewers: leinir

Reviewed By: leinir

Subscribers: kde-frameworks-devel

Tags: Frameworks

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