Create Plan your upgrade rollout doc

[janugeethakumari-okta]

Description

• What's changed?
  Adds a new developer guide, Plan your upgrade rollout, for the "Prepare to Upgrade to Okta Identity Engine" journey.
  The guide walks developers and admins through sequencing org upgrades (preview → sandbox → production), rolling out Identity Engine flows gradually to user segments using code-based routing, load balancing, or incremental scaling, and replacing deprecated features — Integrated Windows Authentication, Device Trust, and Okta Mobile — before the upgrade.

This update also adds five new sections sourced from gaps identified against the admin-facing help.okta.com content:

• Upgrade your Sign-In Widget
• Update event hook endpoints
• Prepare Terraform for the upgrade
• Build a test plan
• Plan for rollback

Files changed:

• Add docs/guides/oie-upgrade-rollout-plan/ (index.md + main/index.md)
• Register the guide in docs/guides/index.md
• Add the guide to the Okta Identity Engine upgrade section in navbar.const.js

Is this PR related to a Monolith release?
No. Targeting the July monthly developer docs release (code freeze June 26, 2026.07.0).

Resolves

• OKTA-1192952

Netlify preview link

Preview link

[okta-prod-github-app]

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article	Total score Required:80	Word and phrases (Brand, terms) Preferred: 80	Correctness (Spelling, grammar) Preferred: 80	Clarity (Readability) Preferred: 80	Inclusive language (+ accesibility) Preferred: 80
✅ packages/@okta/vuepress-site/docs/guides/index.md	87	67	80	78
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/index.md	100	100	100	100
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/main/index.md	78	66	100	59

Successfully checked 3 of 3 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

[okta-prod-github-app]

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article	Total score Required:80	Word and phrases (Brand, terms) Preferred: 80	Correctness (Spelling, grammar) Preferred: 80	Clarity (Readability) Preferred: 80	Inclusive language (+ accesibility) Preferred: 80
✅ packages/@okta/vuepress-site/docs/guides/index.md	87	67	80	78
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/index.md	100	100	100	100
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/main/index.md	79	66	100	62

Successfully checked 3 of 3 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

[okta-prod-github-app]

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article	Total score Required:80	Word and phrases (Brand, terms) Preferred: 80	Correctness (Spelling, grammar) Preferred: 80	Clarity (Readability) Preferred: 80	Inclusive language (+ accesibility) Preferred: 80
✅ packages/@okta/vuepress-site/docs/guides/index.md	87	67	80	78
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/index.md	100	100	100	100
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/main/index.md	81	76	100	67

Successfully checked 3 of 3 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

[okta-prod-github-app]

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article	Total score Required:80	Word and phrases (Brand, terms) Preferred: 80	Correctness (Spelling, grammar) Preferred: 80	Clarity (Readability) Preferred: 80	Inclusive language (+ accesibility) Preferred: 80
✅ packages/@okta/vuepress-site/docs/guides/index.md	87	67	80	78
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/index.md	100	100	100	100
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/main/index.md	80	77	89	67

Successfully checked 3 of 3 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.

[okta-prod-github-app]

Acrolinx score

A minimum Acrolinx Score of 80 is required. The total score is an average of the subscores.
Select Total score to review the Acrolinx scorecard for your article. Try to increase your individual scores, for example: Correctness. Your content will be clearer and more consistent.

Article	Total score Required:80	Word and phrases (Brand, terms) Preferred: 80	Correctness (Spelling, grammar) Preferred: 80	Clarity (Readability) Preferred: 80	Inclusive language (+ accesibility) Preferred: 80
✅ packages/@okta/vuepress-site/docs/guides/index.md	87	67	80	78
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/index.md	100	100	100	100
✅ packages/@okta/vuepress-site/docs/guides/oie-upgrade-rollout-plan/main/index.md	81	80	92	66

Successfully checked 3 of 3 documents.
See summary in Content Analysis Dashboard

Reopen the pull request or push new changes to check again.

Depending on the Acrolinx server configuration, the
links expire after some time and you must have a login for the
Acrolinx server to access them again.