Improve ARC documentation
commita3abd0ff19d53b3ea3d685a77d88ecc51c3ae2d0
authorJonas Schäfer <jonas@zombofant.net>
Tue, 13 Dec 2022 22:45:35 +0000 (13 22:45 +0000)
committerMark Sapiro <mark@msapiro.net>
Tue, 13 Dec 2022 22:45:35 +0000 (13 22:45 +0000)
treefc8b13a3448581171030c2b6ef423154b2505ae5
parent0c1b507d69ae8dd9d75b6cc185dccb154c120b2c
Improve ARC documentation

I had a bit of a hard time setting up ARC because of gaps in the documentation.

First, I had to hunt down the Unparsable private key exception.

Then I got a weird Syntax Error exception caused by the lack of `authserv_id` in my config. I did not set that initially because as I read the documentation, I thought I only needed that if mailman does **not** do its own DMARC/DKIM checks (the heading "trusted domains" confused me. It makes somewhat sense in schema.cfg, but not in the rendered docs).

I hope this is an improvement, this wording and layout would've helped me a lot anyway.
src/mailman/config/schema.cfg
src/mailman/handlers/docs/arc_sign.rst