doc: release-notes: add notes about <zephyr/zephyr.h> deprecation

Inform about the <zephyr/zephyr.h> deprecation, add details on what
users need to do.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>