From bb5bba814441d4f19a284da0f1c5724d866ced3d Mon Sep 17 00:00:00 2001 From: KieranVR Date: Mon, 25 May 2026 14:54:16 -0700 Subject: [PATCH] docs: improve discoverability of forgot password reset instructions - Add dedicated 'Forgot Your Password' guide page under Getting Started - Add prominent Callout + updated links in Initial Setup page - Promote the new page as the top link in the 'cannot log in' troubleshooting path - Update FAQ entry to point to the new authoritative guide - Register the page in the Getting Started sidebar navigation Addresses user feedback that the password reset instructions were hard to find (buried in troubleshooting accordion and only mentioned briefly in FAQ). --- components/troubleshooting-flow.tsx | 3 +- content/docs/faq.mdx | 6 +- .../docs/getting-started/forgot-password.mdx | 70 +++++++++++++++++++ .../docs/getting-started/initial-setup.mdx | 9 ++- content/docs/getting-started/meta.json | 3 +- 5 files changed, 86 insertions(+), 5 deletions(-) create mode 100644 content/docs/getting-started/forgot-password.mdx diff --git a/components/troubleshooting-flow.tsx b/components/troubleshooting-flow.tsx index f9c82a4..67d27e9 100644 --- a/components/troubleshooting-flow.tsx +++ b/components/troubleshooting-flow.tsx @@ -84,12 +84,13 @@ const troubleshootingPaths: TroubleshootingPath[] = [ 'Update Codex and the extension to the latest version.', 'Restart the application or reload the editor window.', 'Confirm your password meets the requirements.', - 'Use password reset if you already created an account.', + 'Use the Forgot Password option on the login screen (detailed guide available).', 'Make sure the app has the permissions it requests.', 'Check your network if the issue involves sign-in or AI access.', 'Check the Codex Status page (status.codexeditor.com) to see if the servers are currently down.', ], docs: [ + { title: 'Forgot Password', href: '/docs/getting-started/forgot-password' }, { title: 'Initial Setup', href: '/docs/getting-started/initial-setup' }, { title: 'FAQ', href: '/docs/faq' }, { title: 'Codex Status', href: 'https://status.codexeditor.com' }, diff --git a/content/docs/faq.mdx b/content/docs/faq.mdx index e09d271..80d4c6f 100644 --- a/content/docs/faq.mdx +++ b/content/docs/faq.mdx @@ -304,7 +304,11 @@ Yes. Projects are stored locally on your device, allowing for offline work. Chan ### I forgot my password. How do I reset it? -Use the password reset option on the login screen. This is why it's important to use a real email address during [registration](/docs/getting-started/initial-setup). +See the full step-by-step guide: + +**[Forgot Your Password →](/docs/getting-started/forgot-password)** + +Use the **Forgot Password** option on the login screen. This is why it's important to use a real email address during [registration](/docs/getting-started/initial-setup). --- diff --git a/content/docs/getting-started/forgot-password.mdx b/content/docs/getting-started/forgot-password.mdx new file mode 100644 index 0000000..ce07169 --- /dev/null +++ b/content/docs/getting-started/forgot-password.mdx @@ -0,0 +1,70 @@ +--- +title: Forgot Your Password +description: "Reset your Codex Editor password if you've forgotten it. Quick guide for the login screen reset flow." +--- + +# Forgot Your Password? + +If you can't remember your password, use the **Forgot Password** flow directly from the Codex login screen. This is the fastest way to regain access. + +## Reset Your Password (Step by Step) + +1. **Open the login screen** + - Launch Codex Editor + - If you're already logged in, log out first (or restart the app to reach the login screen) + +2. **Click "Forgot Password"** + - On the login screen, look for and click the **Forgot Password** option + +3. **Enter your registered email** + - Use the exact email address you used when you created your account + +4. **Check your email** + - Look in your inbox for a password reset email from Codex + - **Also check spam, junk, and promotions folders** + +5. **Click the reset link** + - Open the email and click the password reset link (the link expires after some time) + +6. **Create a new password** + - Must be at least **15 characters** long + - Must contain at least one **uppercase** letter and one **lowercase** letter + - Confirm the new password + +7. **Log in** + - Return to the login screen + - Enter your **username** (case sensitive) or **email address** + - Enter your new password + +## Critical Requirements + + +**You must have used a real email address during registration.** + +Fake or temporary emails cannot receive password reset links. This is why the registration screen strongly warns you to use a real or reliable email. + + +- Usernames are **case sensitive** — double-check capitalization if login fails after reset. +- You can also use your registered **email address** in the username field to log in. + +## Didn't Receive the Reset Email? + +- Wait 2–5 minutes after requesting the reset. +- Search your entire email (including spam) for "Codex", "password", or "reset". +- Request the reset link again — you can do this multiple times. +- Make sure you're entering the **exact email** used at registration. + +If you still cannot receive or complete the reset: + +- Go to the **[Troubleshooting guide](/docs/troubleshooting)** and choose **"I cannot log in or finish setup"**. +- Or contact support on [Discord](https://discord.gg/6kVJTEXYEp) with details of what you've tried. + +## Related Guides + +- [Initial Setup & Registration](/docs/getting-started/initial-setup) — Full account creation and login instructions +- [Frequently Asked Questions](/docs/faq) — Other common account questions +- [Troubleshooting](/docs/troubleshooting) — Guided support flow for login problems + +--- + +**Tip:** Write down or securely store your username and the email you used for registration. This makes future password resets much easier. \ No newline at end of file diff --git a/content/docs/getting-started/initial-setup.mdx b/content/docs/getting-started/initial-setup.mdx index c48cd92..143550a 100644 --- a/content/docs/getting-started/initial-setup.mdx +++ b/content/docs/getting-started/initial-setup.mdx @@ -64,6 +64,11 @@ When you need to log in manually: - Your account password 3. **Click Login**: Submit your credentials to access your account + +Forgot your password? Use the **Forgot Password** option on the login screen. +See the dedicated guide: **[Reset Forgotten Password →](/docs/getting-started/forgot-password)** + + ## Account Security Best Practices ### Password Guidelines @@ -147,7 +152,7 @@ After registering, Codex logs you in automatically. You should not need to log i 1. Enter your **username** (case sensitive) or the **email address** you used to register. 2. Enter your password. 3. If you see an error message, note the exact text. Complete the [Troubleshooting guide](/docs/troubleshooting) support form and paste the generated template into [Discord](https://discord.gg/6kVJTEXYEp). -4. If you forgot your password, use the **Forgot Password** option on the login screen. Check your spam folder for the reset email. +4. If you forgot your password, use the **[Forgot Password](/docs/getting-started/forgot-password)** flow on the login screen. Check your spam folder for the reset email. #### Registration is not working @@ -166,7 +171,7 @@ If registration still fails, complete the [Troubleshooting guide](/docs/troubles #### Common account issues - **Username already taken**: Try variations of your preferred username, or add numbers or underscores to make it unique. -- **Email already registered**: You may already have an account. Try the password reset option if you have forgotten your credentials. +- **Email already registered**: You may already have an account. Use the **[Forgot Password](/docs/getting-started/forgot-password)** flow if you need to regain access. --- diff --git a/content/docs/getting-started/meta.json b/content/docs/getting-started/meta.json index a62ebe7..87b8026 100644 --- a/content/docs/getting-started/meta.json +++ b/content/docs/getting-started/meta.json @@ -2,6 +2,7 @@ "title": "Getting Started", "pages": [ "download-codex", - "initial-setup" + "initial-setup", + "forgot-password" ] } \ No newline at end of file