can we add public docs for this change?

otherwise it looks good.