docs: migration-guide-3.6: notes about userspace funcs renaming

Quite a few of userspace related functions, macros and struct
have been renamed (z_ to k_). So make notes in the migration
guide.

Signed-off-by: Daniel Leung <daniel.leung@intel.com>