improved documentation around blind updates