update documentation to mention confirmation stuff

Thanks: Christian Amsüss <chrysn@fsfe.org> for requesting that feature