Skip to content

Email section rewrite#1662

Closed
aeden wants to merge 15 commits intomainfrom
email-section-rewrite
Closed

Email section rewrite#1662
aeden wants to merge 15 commits intomainfrom
email-section-rewrite

Conversation

@aeden
Copy link
Member

@aeden aeden commented Nov 20, 2025

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
Copy link
Contributor

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
Copy link
Contributor

Okay, so Cursor is now catching APA style.

Fixing the title case mismatches in emails.yaml


Email forwarding is applied on a per-domain basis.

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

Choose a reason for hiding this comment

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

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


## View email forwarding configuration

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

Choose a reason for hiding this comment

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

The screenshot needs to be updated


![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]`).
Copy link
Contributor

Choose a reason for hiding this comment

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

This is incorrect.


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.
Copy link
Contributor

Choose a reason for hiding this comment

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

Create forward button

## 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.

Copy link
Contributor

Choose a reason for hiding this comment

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

could probably add a screenshot here

### Email Hosting
- ✅ Email Hosting Support (Explanation)

## Identified Gaps
Copy link
Contributor

Choose a reason for hiding this comment

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

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

## 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
Copy link
Contributor

Choose a reason for hiding this comment

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

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

@stephanoodle stephanoodle requested a review from Pemacaa November 25, 2025 16:26
To get started with email forwarding:

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

@Pemacaa Pemacaa Nov 25, 2025

Choose a reason for hiding this comment

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

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.

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.
Copy link
Contributor

Choose a reason for hiding this comment

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

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

Copy link
Member

Choose a reason for hiding this comment

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

With the new catch-all feature, we have the following options. We don't explicitly call it 'from':

Screenshot 2025-12-11 at 10 27 31

@stephanoodle
Copy link
Contributor

Today, I am taking the gaps article and creating the content with Cursor. My plan is to have Cursor merge them into the email-section-rewrite branch.

- Confirm deletions

<info>
**One-click services:** If you're using DNSimple's one-click services for your old provider, you can remove the service, which will automatically remove the associated DNS records. See [Removing Services](/articles/services/#removing-services) for instructions.
Copy link
Contributor

Choose a reason for hiding this comment

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

verify

**Solutions:**
1. **Verify email forwarding enabled:** Check that email forwarding is enabled in DNSimple
2. **Check email forwards:** Verify all email forwards are configured correctly
3. **Test DNS:** Use `dig` to verify MX records point to DNSimple
Copy link
Contributor

Choose a reason for hiding this comment

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

fix


### Sender reputation tools

**Sender Score (sender-score.org):**
Copy link
Contributor

@stephanoodle stephanoodle Dec 5, 2025

Choose a reason for hiding this comment

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

this doesn't exist. URL is https://senderscore.org/

- Monitor trends over time
- Address issues that affect score

**Google Postmaster Tools:**
Copy link
Contributor

Choose a reason for hiding this comment

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

- Monitor Gmail-specific metrics
- Address Gmail-specific issues

**Microsoft SNDS (Smart Network Data Services):**
Copy link
Contributor

Choose a reason for hiding this comment

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


### Blacklist monitoring

**MXToolbox:**
Copy link
Contributor

Choose a reason for hiding this comment

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

- Address blacklist issues immediately

**Other tools:**
- Spamhaus
Copy link
Contributor

Choose a reason for hiding this comment

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


**Other tools:**
- Spamhaus
- BarracudaCentral
Copy link
Contributor

Choose a reason for hiding this comment

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

**Other tools:**
- Spamhaus
- BarracudaCentral
- SURBL
Copy link
Contributor

@stephanoodle stephanoodle Dec 5, 2025

Choose a reason for hiding this comment

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

stephanoodle and others added 2 commits December 9, 2025 14:05
- Remove EMAILS_GAP_ANALYSIS.md (working document, no longer needed)
- Clarify distinction between managing-email-forwards.md (step-by-step guide) and email-forwarding-management.md (UI reference)
- Add cross-references between articles for better navigation
- Focus each article on its distinct purpose
![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.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
1. **Add email forward** button - Create a new email forward.
1. **Add** button - Create a new email forward.


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.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
1. **Current Email Forwards** section - List of all configured email forwards.
1. Current Email Forwards section - List of all configured email forwards.

stephanoodle and others added 4 commits December 9, 2025 14:14
- Delete content/articles/email-forwarding-with-subdomains.md
- Remove references from emails.md and email-forwarding.md
- Add links to Record Editor where mentioned
- Add links to 'What Is' articles for SPF, DKIM, DMARC
- Add links to advanced authentication topics (alignment, gradual DMARC, multiple DKIM selectors)
- Add links to email bounce articles
- Add links to email security and authentication best practices
- Expand and reorganize Related topics section with categories
- Remove .vscode/tasks.json from repository
- Add .vscode/ to .gitignore
…icles

- Add links to reputation monitoring tools (Sender Score, Google Postmaster Tools, Microsoft SNDS, BarracudaCentral)
- Add links to blacklist monitoring tools (MXToolbox, Spamhaus, SURBL)
- Add links to email testing tools (Mail-Tester, Litmus, Email on Acid)
- Add links to DMARC reporting tools (dmarcian, Postmark)
- Add links to dashboard tools (Google Analytics, Google Data Studio, Tableau)
- Improve tool descriptions with brief explanations
stephanoodle and others added 3 commits December 9, 2025 14:37
- Add context about SPF as part of email authentication (SPF, DKIM, DMARC)
- Add links to integration guides for Google Workspace and Microsoft 365 examples
- Add link to third-party email services integration guide
- Improve mechanisms section with clearer reference to detailed guide
- Add troubleshooting section with link to troubleshooting guide
- Add comprehensive Related topics section organized by category:
  - Email authentication (SPF, DKIM, DMARC articles)
  - Email service integration (Google Workspace, Microsoft 365, third-party)
  - DNS management (Record Editor, TXT records)
- Update categories/emails.yaml to include all 48 articles from email-section-rewrite PR
- Organize articles by Diataxis framework (Getting started, Explanation, How to, Reference)
- Add missing meta descriptions to emails.md and enabling-email-forwarding.md
- Ensure all articles have both excerpt and meta fields for SEO
@stephanoodle
Copy link
Contributor

This PR has been split into 11 smaller, more manageable PRs for easier review:

Split PRs:

  1. PR Email Forwarding - Core & Getting Started #1695 - Email Forwarding - Core & Getting Started
  2. PR Email Forwarding - Advanced Management #1696 - Email Forwarding - Advanced Management
  3. PR Email Forwarding - Troubleshooting #1697 - Email Forwarding - Troubleshooting
  4. PR Email Authentication - Setup Guides #1698 - Email Authentication - Setup Guides
  5. PR Email Authentication - Advanced Topics #1699 - Email Authentication - Advanced Topics
  6. PR Email Services Integration #1700 - Email Services Integration
  7. PR Email DNS Records Management #1701 - Email DNS Records Management
  8. PR Email Deliverability #1702 - Email Deliverability
  9. PR Email Security & Best Practices #1703 - Email Security & Best Practices
  10. PR Email Troubleshooting - Authentication #1704 - Email Troubleshooting - Authentication
  11. PR Email Category Structure & Navigation #1705 - Email Category Structure & Navigation

All PRs are currently in draft status and ready for review. This large PR is being closed in favor of the smaller, focused PRs above.

@stephanoodle
Copy link
Contributor

This PR has been split into 11 smaller, more manageable PRs. See the comment above for the list of new PRs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants