updated documentation wrt. layer switches