Update remove-repository documentation

What does this MR do and why?

The praefect remove-repository subcommand has been updated to run in dry-run by default and will actually remove the repository only if the -apply flag is provided. This commit adds documentation to clarify this behavior.

gitaly!4054 (merged) is the gitaly mr where we made this change

MR acceptance checklist

This checklist encourages us to confirm any changes have been analyzed to reduce risks in quality, performance, reliability, security, and maintainability.

• I have evaluated the MR acceptance checklist for this MR.