Skip to content

Conversation

@wassimoo
Copy link
Contributor

Related Issue or Design Document

Fixes the Auth0 export script and improves the migration guide documentation for better clarity.

Changes

Script Fixes (0-get-auth0-user-data.sh)

  • Added error handling and validation for environment variables.
  • Fixed connection_id string interpolation bug.
  • Improved polling logic with proper error states handling.
  • Better user feedback with clear success/error messages.

Documentation Improvements (auth0.mdx)

  • Restructured content into three clear phases:
    • Prepare Auth0 data.
    • Configure Ory project.
    • Import users to Ory.
  • Added prerequisites section with all requirements upfront.
  • Added tip box for finding project/workspace IDs.
  • Clarified file outputs: script creates AUTH0_USERDATA.json automatically.
  • Enhanced post-migration section with verification and testing steps.

Impact

  • Prevents silent script failures with proper error handling
  • Makes migration guide easier to follow with logical phase structure

Checklist

  • I have read the contributing guidelines and signed the CLA.
  • I have referenced an issue containing the design document if my change introduces a new feature.
  • I have read the security policy.
  • I confirm that this pull request does not address a security vulnerability.
    If this pull request addresses a security vulnerability,
    I confirm that I got approval (please contact security@ory.com) from the maintainers to push the changes.
  • I have added tests that prove my fix is effective or that my feature works.
  • I have added the necessary documentation within the code base (if appropriate).

@CLAassistant
Copy link

CLAassistant commented Oct 27, 2025

CLA assistant check
All committers have signed the CLA.

Copy link
Member

@vinckr vinckr left a comment

Choose a reason for hiding this comment

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

Nice!
looks pretty good already, I would do a test of the script and left some comments on style.

I think the numbered list here don't add anything and in general would be better without.
there are 2 steps only anyway so its not that hard to navigate and just looks confusing in the ToC (see screenshot below).

So please remove the Phase X parts and numbered list in headings.

also in line with the style guide: "Avoid using symbols and special characters in headings."

Image

:shipit:

Copy link
Contributor

@unatasha8 unatasha8 left a comment

Choose a reason for hiding this comment

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

Added a bunch of suggestions.

vinckr
vinckr previously requested changes Nov 17, 2025
@wassimoo wassimoo merged commit 4e6c0ae into master Nov 24, 2025
9 checks passed
@wassimoo wassimoo deleted the wassimoo/fix-auth0-migration-and-update-docs branch November 24, 2025 12:57
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.

5 participants