Add more documentation and inline explanatory comments in assembly sources swap_helper.S and userspace.S and remove redundant/wrong documentation when applicable. Signed-off-by: Ioannis Glaropoulos <Ioannis.Glaropoulos@nordicsemi.no>