From 8970ed08496e83b5b9a8bc1fc0bf94c7d58ab24d Mon Sep 17 00:00:00 2001 From: Jeremy Fleischman Date: Sun, 13 Apr 2025 10:56:07 -0700 Subject: [PATCH] Suggest that folks enable DMARC reporting SNM supports DMARC reporting, but it's disabled by default. For email greybeards, that's fine, but I think it would be useful to teach email newbies (as I was a few months ago) that this is something you should seriously consider enabling. I opted to put this in a new "Advanced Configurations" section that points experienced mailserver admins to our howto guides, and newbies to a couple of important things. refs: https://github.com/NixOS/infra/pull/635 --- docs/advanced-configurations.rst | 14 ++++++++++++++ docs/index.rst | 1 + docs/setup-guide.rst | 5 +++++ 3 files changed, 20 insertions(+) create mode 100644 docs/advanced-configurations.rst diff --git a/docs/advanced-configurations.rst b/docs/advanced-configurations.rst new file mode 100644 index 0000000..e2b7837 --- /dev/null +++ b/docs/advanced-configurations.rst @@ -0,0 +1,14 @@ +Advanced Configurations +======================= + +Congratulations on completing the `Setup Guide `_! + +If you're an experienced mailserver admin, then you probably know what you want +to do next. Our How-to guides (accessible in the navigation sidebar) +might help you accomplish your goals. If not, consider contributing a guide! + +If this is your first mailserver, consider the following: + +- Set up `backups `_. +- Enable `DMARC reporting `_ to be a + good citizen in the mail ecosystem. diff --git a/docs/index.rst b/docs/index.rst index 2fd1e1a..3dd919a 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -14,6 +14,7 @@ Welcome to NixOS Mailserver's documentation! :maxdepth: 2 setup-guide + advanced-configurations howto-develop faq release-notes diff --git a/docs/setup-guide.rst b/docs/setup-guide.rst index 08de1b3..35b6889 100644 --- a/docs/setup-guide.rst +++ b/docs/setup-guide.rst @@ -236,3 +236,8 @@ Besides that, you can send an email to score, and let `mxtoolbox.com `__ take a look at your setup, but if you followed the steps closely then everything should be awesome! + +Next steps (optional) +~~~~~~~~~~~~~~~~~~~~~ + +Take a look through our `Advanced Configurations `_.