Skip to content

Fix: Remove outdated Email OTP configuration steps for versions 6.0.0 and 6.1.0 (Product IS issue #26846)#5922

Open
wso2-engineering-bot wants to merge 1 commit intomasterfrom
fixing-product-is-issue-26846-1772115607
Open

Fix: Remove outdated Email OTP configuration steps for versions 6.0.0 and 6.1.0 (Product IS issue #26846)#5922
wso2-engineering-bot wants to merge 1 commit intomasterfrom
fixing-product-is-issue-26846-1772115607

Conversation

@wso2-engineering-bot
Copy link

@wso2-engineering-bot wso2-engineering-bot commented Feb 26, 2026

This PR was automatically generated by Claude AI.

  • Fixes Outdated steps in Email OTP as second step doc product-is#26846
  • Type: Documentation
  • Summary: Removed outdated and unnecessary Email OTP configuration steps including the "Add the email template" section (as EmailOTP template is available by default) and the non-mandatory "configure local claims" prerequisite step.
  • Affected Versions: 6.0.0, 6.1.0
  • Style Scope Verification: Changes involve removal of outdated content only. No new content requiring Microsoft Style Guidelines compliance was added.
  • Verification: mkdocs build passed successfully

Changes Made:

  1. Removed the "Add the email template" section - This step is unnecessary as EmailOTP template is available by default in the product
  2. Removed the "configure local claims" prerequisite - This step is not mandatory for Email OTP configuration

Summary by CodeRabbit

  • Documentation
    • Simplified email OTP two-factor authentication setup guides by removing manual email template configuration requirements.
    • Updated prerequisite steps to streamline the setup process, now emphasizing user profile configuration with email addresses and Identity Provider registration.

… and 6.1.0 (product-is#26846)

- Removed unnecessary "Add the email template" section as EmailOTP template is available by default
- Removed non-mandatory "configure local claims" prerequisite step

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@CLAassistant
Copy link

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.


wso2-engineering-bot seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 26, 2026

Walkthrough

Documentation files for Email OTP configuration were updated to remove unnecessary email template setup instructions and simplify prerequisites by eliminating redundant local claims configuration steps, replacing them with user profile and identity provider registration guidance.

Changes

Cohort / File(s) Summary
Email OTP Documentation Updates
en/identity-server/6.0.0/docs/guides/mfa/2fa-email-otp.md, en/identity-server/6.1.0/docs/guides/mfa/2fa-email-otp.md
Removed the entire "Add the email template" section and simplified prerequisites by removing local claims configuration steps, replacing them with user profile updates and identity provider registration instructions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 Hops with glee

Email templates trimmed with care,
Outdated steps we needn't bear,
Prerequisites now lean and bright,
The docs shine clear and light! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The description addresses the main purpose and changes but lacks security checks and test environment sections required by the template. Complete the description template by adding test environment details and security checks checkboxes to meet repository standards.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the primary change: removing outdated Email OTP configuration steps for versions 6.0.0 and 6.1.0, with clear reference to the linked issue.
Linked Issues check ✅ Passed The PR successfully addresses both objectives from issue #26846: removing the outdated email template section and the non-mandatory configure local claims steps.
Out of Scope Changes check ✅ Passed All changes are within scope and directly address the requirements of issue #26846; no unrelated modifications were introduced.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch fixing-product-is-issue-26846-1772115607

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

🧹 Nitpick comments (2)
en/identity-server/6.1.0/docs/guides/mfa/2fa-email-otp.md (1)

107-109: Consider more concise and active phrasing for prerequisites.

The prerequisites are clear and accurate, but the repetitive "You need to" construction and the passive future phrase "to which the user will receive" could be more concise and direct. As per coding guidelines, use active voice and present tense, reduce weak verb constructions, and prefer direct verbs.

✍️ Suggested refinement for more direct style
-- You need to [set up the sample]({{base_path}}/guides/adaptive-auth/adaptive-auth-overview/#set-up-the-sample) application.
-- You need to [update the User Profile]({{base_path}}/guides/identity-lifecycles/update-profile) of the users with an email address to which the user will receive the OTP.
-- You need to [register an Identity Provider]({{base_path}}/guides/identity-federation/add-idp/) named `emailOTP`.
+- [Set up the sample]({{base_path}}/guides/adaptive-auth/adaptive-auth-overview/#set-up-the-sample) application.
+- [Update the User Profile]({{base_path}}/guides/identity-lifecycles/update-profile) of the users with an email address that receives the OTP.
+- [Register an Identity Provider]({{base_path}}/guides/identity-federation/add-idp/) named `emailOTP`.

As per coding guidelines: "Use active voice and present tense" and "Reduce unnecessary use of weak 'be' verbs and prefer direct verbs."

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@en/identity-server/6.1.0/docs/guides/mfa/2fa-email-otp.md` around lines 107 -
109, Rewrite the three prerequisite bullet points to use active voice, present
tense, and concise verbs: replace "You need to [set up the
sample]({{base_path}}/guides/adaptive-auth/adaptive-auth-overview/#set-up-the-sample)
application." with "Set up the sample application." replace "You need to [update
the User Profile]({{base_path}}/guides/identity-lifecycles/update-profile) of
the users with an email address to which the user will receive the OTP." with
"Update users' profiles with an email address to receive the OTP." and replace
"You need to [register an Identity
Provider]({{base_path}}/guides/identity-federation/add-idp/) named `emailOTP`."
with "Register an Identity Provider named `emailOTP`." Keep the same links and
the `emailOTP` identifier unchanged.
en/identity-server/6.0.0/docs/guides/mfa/2fa-email-otp.md (1)

107-109: Consider more concise and active phrasing for prerequisites.

The prerequisites are clear and accurate, but the repetitive "You need to" construction and the passive future phrase "to which the user will receive" could be more concise and direct. As per coding guidelines, use active voice and present tense, reduce weak verb constructions, and prefer direct verbs.

✍️ Suggested refinement for more direct style
-- You need to [set up the sample]({{base_path}}/guides/adaptive-auth/adaptive-auth-overview/#set-up-the-sample) application.
-- You need to [update the User Profile]({{base_path}}/guides/identity-lifecycles/update-profile) of the users with an email address to which the user will receive the OTP.
-- You need to [register an Identity Provider]({{base_path}}/guides/identity-federation/add-idp/) named `emailOTP`.
+- [Set up the sample]({{base_path}}/guides/adaptive-auth/adaptive-auth-overview/#set-up-the-sample) application.
+- [Update the User Profile]({{base_path}}/guides/identity-lifecycles/update-profile) of the users with an email address that receives the OTP.
+- [Register an Identity Provider]({{base_path}}/guides/identity-federation/add-idp/) named `emailOTP`.

As per coding guidelines: "Use active voice and present tense" and "Reduce unnecessary use of weak 'be' verbs and prefer direct verbs."

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@en/identity-server/6.0.0/docs/guides/mfa/2fa-email-otp.md` around lines 107 -
109, Replace the three prerequisite bullets to use active voice and present
tense: change "You need to [set up the sample]..." to "Set up the sample
application.", change "You need to [update the User Profile]... with an email
address to which the user will receive the OTP." to "Update the user profile
with an email address where the user receives the OTP." and change "You need to
[register an Identity Provider]... named `emailOTP`." to "Register an Identity
Provider named `emailOTP`."; keep the same links and reference text but use
these concise imperative sentences.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@en/identity-server/6.0.0/docs/guides/mfa/2fa-email-otp.md`:
- Around line 107-109: Replace the three prerequisite bullets to use active
voice and present tense: change "You need to [set up the sample]..." to "Set up
the sample application.", change "You need to [update the User Profile]... with
an email address to which the user will receive the OTP." to "Update the user
profile with an email address where the user receives the OTP." and change "You
need to [register an Identity Provider]... named `emailOTP`." to "Register an
Identity Provider named `emailOTP`."; keep the same links and reference text but
use these concise imperative sentences.

In `@en/identity-server/6.1.0/docs/guides/mfa/2fa-email-otp.md`:
- Around line 107-109: Rewrite the three prerequisite bullet points to use
active voice, present tense, and concise verbs: replace "You need to [set up the
sample]({{base_path}}/guides/adaptive-auth/adaptive-auth-overview/#set-up-the-sample)
application." with "Set up the sample application." replace "You need to [update
the User Profile]({{base_path}}/guides/identity-lifecycles/update-profile) of
the users with an email address to which the user will receive the OTP." with
"Update users' profiles with an email address to receive the OTP." and replace
"You need to [register an Identity
Provider]({{base_path}}/guides/identity-federation/add-idp/) named `emailOTP`."
with "Register an Identity Provider named `emailOTP`." Keep the same links and
the `emailOTP` identifier unchanged.

ℹ️ Review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between da660e7 and 043924b.

📒 Files selected for processing (2)
  • en/identity-server/6.0.0/docs/guides/mfa/2fa-email-otp.md
  • en/identity-server/6.1.0/docs/guides/mfa/2fa-email-otp.md

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.

Outdated steps in Email OTP as second step doc

2 participants