Merge pull request #1900 from tnull/2022-12-improve-confirm-docs