Email section rewrite #1662

aeden · 2025-11-20T22:48:18Z

Start with the content from all articles in the Emails and replace the existing articles with new articles using the Diataxis framework (https://diataxis.fr/) and following the voice from articles in the DNSSEC and DNS category, . Produce a list of gaps of missing articles for the Emails category that should be added in the future based on functionality provided by DNSimple related to email. Create a new pillar page for the Emails category using https://support.dnsimple.com/articles/dnssec/ as an example template.

Using the code in dnsimple-app review the articles in the Email section and correct any outdated documentation.

stephanoodle · 2025-11-20T23:09:41Z

content/articles/setting-up-spf.md

This is a good example of a doc that we were talking about writing, but then decided against it.

It's interesting to see that the AI believes it is important.

stephanoodle · 2025-11-21T19:47:34Z

Okay, so Cursor is now catching APA style.

Fixing the title case mismatches in emails.yaml

stephanoodle · 2025-11-25T00:45:05Z

content/articles/email-forwarding-management.md

+
+Email forwarding is applied on a per-domain basis.
+
+ ![screenshot of UI for email forwarding on a domain](/files/forwarding-tab.png)


This screenshot is out of date and needs to be replaced.

stephanoodle · 2025-11-25T00:45:48Z

content/articles/email-forwarding-management.md

+ ![screenshot of UI for email forwarding on a domain](/files/forwarding-tab.png)
+
+1. **Email Forwarding** tab - Email forwarding management options for the domain.
+1. **Add email forward** button - Create a new email forward.


Add button

stephanoodle · 2025-11-25T00:46:30Z

content/articles/email-forwarding-management.md

+
+1. **Email Forwarding** tab - Email forwarding management options for the domain.
+1. **Add email forward** button - Create a new email forward.
+1. **Current Email Forwards** section - List of all configured email forwards.


This section does exist, but it doesn't actually have a header...

stephanoodle · 2025-11-25T00:47:33Z

content/articles/email-forwarding-management.md

+
+## View email forwarding configuration
+
+![screenshot of viewing email forwarding configuration](/files/new-email-forward.png)


The screenshot needs to be updated

stephanoodle · 2025-11-25T00:48:07Z

content/articles/email-forwarding-management.md

+
+![screenshot of viewing email forwarding configuration](/files/new-email-forward.png)
+
+1. **From** field - The local part of the email address to forward from (e.g., `hello` for `[email protected]`).


This is incorrect.

stephanoodle · 2025-11-25T00:48:27Z

content/articles/email-forwarding-management.md

+
+1. **From** field - The local part of the email address to forward from (e.g., `hello` for `[email protected]`).
+1. **To** field - The full email address where emails should be forwarded.
+1. **Add email forward** button - Creates the email forward.


Create forward button

stephanoodle · 2025-11-25T00:50:55Z

content/articles/email-forwarding-management.md

+## Catch-all email forwarding
+
+To create a catch-all email forward, select the **Catch-all** option when creating a new email forward. This will forward emails sent to any address at your domain that doesn't have a specific forwarding rule.
+


could probably add a screenshot here

stephanoodle · 2025-11-25T00:54:03Z

content/articles/emails.md

@@ -0,0 +1,62 @@
+---


I think this might be the pillar page

stephanoodle · 2025-11-25T04:12:35Z

content/articles/enabling-email-forwarding.md

+1. Use the **account switcher** at the top of the page to select the appropriate account.
+  ![screenshot of switching accounts](/files/switch-account.png)
+1. In your **Domain Names** list, click the name of the domain you want to enable email forwarding on.
+  ![screenshot of list of domain names](/files/dnssec-domain-names.png)


Im impressed that cursor found this screenshot and knew it could also be used here.

stephanoodle · 2025-11-25T04:18:45Z

content/articles/managing-email-forwards.md

+To view all email forwards for a domain:
+
+1. Navigate to the domain's **Email Forwarding** tab.
+1. All configured email forwards are listed in the **Current Email Forwards** section.


this isn't totally correct

That's true. We do not have a current email forward section.

stephanoodle · 2025-11-25T04:29:00Z

content/articles/managing-email-forwards.md

+
+1. Navigate to the domain's **Email Forwarding** tab.
+1. Find the email forward you want to edit in the **Current Email Forwards** section.
+1. Click **Edit** (or the pencil icon).


only option is pencil icon

stephanoodle · 2025-11-25T04:29:14Z

content/articles/managing-email-forwards.md

+1. Navigate to the domain's **Email Forwarding** tab.
+1. Find the email forward you want to edit in the **Current Email Forwards** section.
+1. Click **Edit** (or the pencil icon).
+1. Modify the **From** or **To** fields as needed.


not quite right

stephanoodle · 2025-11-25T04:30:21Z

content/articles/managing-email-forwards.md

+To remove an email forward from your domain:
+
+1. Navigate to the domain's **Email Forwarding** tab.
+1. Locate the email forwarding configuration that you want to delete under the **Current Email Forwards** section.


current email forwards section isn't actually a thing...

stephanoodle · 2025-11-25T04:30:35Z

content/articles/managing-email-forwards.md

+
+1. Navigate to the domain's **Email Forwarding** tab.
+1. Locate the email forwarding configuration that you want to delete under the **Current Email Forwards** section.
+1. Click **Delete** (or the trash can icon).


only trash can icon is available

stephanoodle · 2025-11-25T04:31:39Z

content/articles/setting-up-spf.md

+excerpt: How to set up SPF records in your DNSimple account.
+meta: Learn how to set up SPF records for email authentication and what to expect from your email provider.
+categories:
+- DNS


I like that Cursor figured out that this would also go in DNS

stephanoodle · 2025-11-25T04:32:49Z

content/articles/setting-up-spf.md

+
+SPF records are published as [TXT records](/articles/txt-record/) in your DNS zone. The record contains a list of IP addresses and/or hostnames that are permitted to send email from your domain.
+
+<info>


This is also in What Is an SPF Record? article. I'm not sure if we'd want it in both places.

stephanoodle · 2025-11-25T04:34:01Z

content/articles/setting-up-spf.md

+v=spf1 ip4:192.0.2.1 include:_spf.google.com ~all
+```
+
+## Understanding SPF mechanisms


This is in the other SPF article and could be removed.

stephanoodle · 2025-11-25T04:50:48Z

EMAILS_GAP_ANALYSIS.md

+### Email Hosting
+- ✅ Email Hosting Support (Explanation)
+
+## Identified Gaps


These are all good gaps that could easily be filled/cross referenced from other categories.

stephanoodle · 2025-11-25T04:51:28Z

EMAILS_GAP_ANALYSIS.md

+## Notes
+
+- Some topics (like MX records) exist in the DNS category but should be cross-referenced or duplicated in the Emails category for better discoverability
+- One-click services for email are covered in the Services category, which is appropriate, but the Emails category should have integration guides


I'm not sure I agree with integration guides in Email..

Pemacaa · 2025-11-25T18:40:07Z

content/articles/email-forwarding-management.md

+When you have a catch-all email forward, it only applies to emails sent to addresses that do not already have a specific email forward set up. If an email is sent to an address that has a matching email forward, only that email forward will handle it; the catch-all will not apply.
+</info>
+
+## Email forwarding limits


I like that that it created a part for the email forward limits

Pemacaa · 2025-11-25T18:47:19Z

content/articles/email-forwarding.md

+To get started with email forwarding:

-## Internationalized Domain Names (IDN) support {#idna}
+1. Ensure you're subscribed to a plan that includes email forwarding.


All plans include email forwarding. Make sure you are subscribed to an active plan, the domain is delegated to DNSimple’s name servers, and DNS hosting is active.

Pemacaa · 2025-11-25T19:14:01Z

content/articles/enabling-email-forwarding.md

+You must be [subscribed to a plan](https://dnsimple.com/pricing) to enable email forwarding. Email forwarding is enabled and billed monthly on a per-domain basis.
+
+The number of forwarded messages and email forwards allowed per month is based on your plan. [See the differences between plans](https://dnsimple.com/pricing).
+


add one more prerequisite:

Suggested change

The domain must be delegated to DNSimple's name servers, and DNS hosting must be active for email forwarding to work.

Pemacaa · 2025-11-25T19:26:56Z

content/articles/managing-email-forwards.md

+1. Use the **account switcher** at the top of the page to select the appropriate account.
+1. In your **Domain Names** list, click the name of the domain where you want to create an email forward.
+1. Click the **Email Forwarding** tab on the left side.
+1. Click **Add email forward** or the **+** button.


Click Add email forward or the continue button.

Pemacaa · 2025-11-25T19:59:27Z

content/articles/managing-email-forwards.md

+1. Click the **Email Forwarding** tab on the left side.
+1. Click **Add email forward** or the **+** button.
+1. Enter the email forward details:
+   - **From:** Enter the local part (the part before the @) of the email address you want to forward from (e.g., `hello` for `[email protected]`). Do not include the domain name.


The From text when creating an email forward does not appear in the UI @sbastn. Shouldn't it be there?

aeden added 2 commits November 20, 2025 14:32

First pass at email section rewrite.

8eeb6df

Update the Email documentation to reflect modified behavior in the app

b8d4af9

Fix catch all instructions

c325e64

stephanoodle reviewed Nov 25, 2025

View reviewed changes

content/articles/emails.md

@@ -0,0 +1,62 @@

---

Copy link

Contributor

stephanoodle Nov 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this might be the pillar page

stephanoodle reviewed Nov 25, 2025

View reviewed changes

stephanoodle requested a review from Pemacaa November 25, 2025 16:26

Pemacaa reviewed Nov 25, 2025

View reviewed changes


		Email forwarding is applied on a per-domain basis.

		![screenshot of UI for email forwarding on a domain](/files/forwarding-tab.png)


		## View email forwarding configuration

		![screenshot of viewing email forwarding configuration](/files/new-email-forward.png)


		![screenshot of viewing email forwarding configuration](/files/new-email-forward.png)

		1. From field - The local part of the email address to forward from (e.g., `hello` for `[email protected]`).

		## Catch-all email forwarding

		To create a catch-all email forward, select the Catch-all option when creating a new email forward. This will forward emails sent to any address at your domain that doesn't have a specific forwarding rule.


		SPF records are published as [TXT records](/articles/txt-record/) in your DNS zone. The record contains a list of IP addresses and/or hostnames that are permitted to send email from your domain.

		<info>

		You must be [subscribed to a plan](https://dnsimple.com/pricing) to enable email forwarding. Email forwarding is enabled and billed monthly on a per-domain basis.

		The number of forwarded messages and email forwards allowed per month is based on your plan. [See the differences between plans](https://dnsimple.com/pricing).


	The domain must be delegated to DNSimple's name servers, and DNS hosting must be active for email forwarding to work.

Email section rewrite #1662

Are you sure you want to change the base?

Email section rewrite #1662

Uh oh!

Conversation

aeden commented Nov 20, 2025

Uh oh!

stephanoodle commented Nov 20, 2025

Uh oh!

stephanoodle commented Nov 21, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Pemacaa Nov 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Pemacaa Nov 25, 2025 •

edited

Loading