Skip to content

Conversation

@hazel-nut
Copy link
Contributor

a major pass at reorganizing the customize emails section of the docs.

the diff is gnarly, so i recommend reviewing (at least initially) by browsing the existing docs in prod to get somewhat familiar with the starting point, and then reading the docs in the deploy preview here nose to tail.

this was primarily a structural edit, but i confirmed a lot of technical info as well, like supported liquid syntax, the functionality of some template parameters, etc. please confirm i correctly nabbed all the necessary redirects as well.

Copy link
Contributor

@nick-gagliardi nick-gagliardi left a comment

Choose a reason for hiding this comment

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

This looks great! Amazing work, and I love the new IA structure. This is much friendlier from a usability and navigation perspective. Few edits, take a look & let me know if you have any questions!

"docs/customize/email/smtp-email-providers/mailgun",
"docs/customize/email/smtp-email-providers/smtp-server",
{
"group": "Custom Configuration with Actions",
Copy link
Contributor

Choose a reason for hiding this comment

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

Logically this makes sense, though I am a little worried about this being nested so far. wdyt?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

i hemmed and hawed about it myself, honestly. ultimately, i went this way to organize it parallel to all the other ways to set up external smtp because one of the things i myself was confused about when i first read these docs was why it was separated out.

imnsho, i think the no-good-answers situation here is indicative of a bigger organizational issue (e.g. why is setting up an smtp provider, a core part of using email workflows at all, nested deep in a customization section?).

but, barring solving a big IA question, i'm open to suggestions on moving this section around. lmk if you have thoughts on where it might go best?

Copy link
Contributor

Choose a reason for hiding this comment

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

cc @daniloasis-auth0 : relevant to our conversation this morning

Co-authored-by: Nick Gagliardi <133918568+nick-gagliardi@users.noreply.github.com>
hazel-nut and others added 2 commits December 17, 2025 12:05
Co-authored-by: Nick Gagliardi <133918568+nick-gagliardi@users.noreply.github.com>
nick-gagliardi
nick-gagliardi previously approved these changes Dec 17, 2025
@hazel-nut hazel-nut merged commit d419131 into main Dec 18, 2025
5 of 6 checks passed
@hazel-nut hazel-nut deleted the edit-email branch December 18, 2025 18:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

main-docs Changes related to auth0's main docs (https://auth0.com/docs)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants