D24770: KLocale api docs: make it easier to find how to port code away from it

[Volker Krause]

vkrause accepted this revision.
This revision is now accepted and ready to land.

REPOSITORY
  R239 KDELibs4Support

BRANCH
  ahmad/klocale-notes (branched from master)

REVISION DETAIL
  https://phabricator.kde.org/D24770

To: ahmadsamir, #frameworks, vkrause
Cc: kde-frameworks-devel, LeGast00n, GB_2, michaelh, ngraham, bruns