working on the catto garden’s docs. i have to add a note for people not to send their pgp pubkeys at the ssh pubkey field. 


That should be recoverable though (old file should be moved to a .dpkg-old counterpart, for apt-based distros). I think the worst is Dovecot making breaking changes with it's config syntax between minor versions (as between 2.3 and 2.4) without backwards-compatibility.
Also for PGP, I just offer a web-based PGP encryption tool, with the public key embedded, to make it stupid-proof.