Skip to content

feat: migration guide updates #2315

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 33 commits into from
Nov 12, 2025
Merged

feat: migration guide updates #2315

merged 33 commits into from
Nov 12, 2025

Conversation

@unatasha8
Copy link
Contributor

@unatasha8 unatasha8 commented Oct 10, 2025 •
edited
Loading

Review draft of updated Migration guide articles (includes sidebar nav changes).

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.sh) 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).

Further comments

@unatasha8 unatasha8 self-assigned this Oct 10, 2025
@unatasha8 unatasha8 added the area/docs This issue affects Ory's documentation. label Oct 10, 2025
@vinckr vinckr changed the title Migration guide updates feat: migration guide updates Oct 15, 2025
@unatasha8 unatasha8 marked this pull request as draft October 15, 2025 15:14
jhickmanit
jhickmanit reviewed Oct 20, 2025
View reviewed changes
jhickmanit
jhickmanit reviewed Oct 20, 2025
View reviewed changes
jhickmanit
jhickmanit reviewed Oct 20, 2025
View reviewed changes
jhickmanit
jhickmanit reviewed Oct 20, 2025
View reviewed changes
jhickmanit
jhickmanit reviewed Oct 20, 2025
View reviewed changes
@piotrmsc piotrmsc marked this pull request as ready for review October 23, 2025 14:24
jonas-jonas
jonas-jonas requested changes Nov 4, 2025
View reviewed changes
Copy link
Member

@jonas-jonas jonas-jonas left a comment

Choose a reason for hiding this comment

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

First pass.

Side note: as a reviewer, it would be very helpful if the actual files had a numbered prefix (e.g. 10_index.mdx, 20_map-to-orycap.mdx, etc.), to make the files appear in the order they're supposed to be read in. That's the usual pattern in the docs repository and makes reviewing these file much easier!
You can still change the actual URL that appears in the browser through the id frontmatter parameter.

@unatasha8 @jonas-jonas
Update docs/migrate-to-ory/migrate/create-project.mdx
6f448c2 
Co-authored-by: Jonas Hungershausen <jonas.hungershausen@ory.sh>
@wassimoo wassimoo self-requested a review November 12, 2025 16:38
wassimoo
wassimoo approved these changes Nov 12, 2025
View reviewed changes
Copy link

@wassimoo wassimoo left a comment

Choose a reason for hiding this comment

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

lgtm!

jonas-jonas
jonas-jonas approved these changes Nov 12, 2025
View reviewed changes
@unatasha8 @jonas-jonas
Update docs/migrate-to-ory/migrate/migrate-strategies.mdx
103a313 
Co-authored-by: Jonas Hungershausen <jonas.hungershausen@ory.sh>
adamwalach and others added 14 commits November 12, 2025 11:24
@adamwalach @unatasha8 @vinckr
docs: switch to calendar-based unified versioning (#2326)
c690685 
* docs: switch to calendar-based unified versioning

* Update docs/ecosystem/upgrading.mdx

* Update docs/ecosystem/upgrading.mdx

* Update docs/ecosystem/upgrading.mdx

* Update docs/ecosystem/upgrading.mdx

* Update docs/ecosystem/upgrading.mdx

* Update docs/ecosystem/upgrading.mdx

* chore: format

---------

Co-authored-by: unatasha8 <una.cogavin@ory.sh>
Co-authored-by: vinckr <vincent@ory.sh>
@nsklikas @unatasha8
@zepatrik @vinckr
docs: add device flow documentation (#2026)
329399e 
* docs: add device flow documentation

* chore: Refine device verification UI section wording

* chore: Update user code entropy configuration details

Clarified the description of user code entropy options and their implications for user entry.

* chore: Revise Device Authorization Grant documentation

Updated the description and steps for the Device Authorization Grant to clarify the process and correct terminology.

* chore: Update device authorization flow steps and formatting

* chore: Added image for device authorization flow

Added an image to illustrate the device authorization flow.

* chore: Fix image path for device authorization flow

* chore: Integrate Mermaid diagram for device authorization flow

Added a sequence diagram to illustrate the device authorization flow using Mermaid.

* Update docs/oauth2-oidc/device-authorization.mdx

Co-authored-by: Patrik <zepatrik@users.noreply.github.com>

* Update docs/oauth2-oidc/device-authorization.mdx

Co-authored-by: Patrik <zepatrik@users.noreply.github.com>

* Update docs/oauth2-oidc/device-authorization.mdx

Co-authored-by: Patrik <zepatrik@users.noreply.github.com>

* Update docs/oauth2-oidc/device-authorization.mdx

Co-authored-by: Patrik <zepatrik@users.noreply.github.com>

* Update docs/oauth2-oidc/device-authorization.mdx

Co-authored-by: Patrik <zepatrik@users.noreply.github.com>

* Update docs/oauth2-oidc/device-authorization.mdx

Co-authored-by: Patrik <zepatrik@users.noreply.github.com>

* chore: address review comments and format

* chore: add to sidebar

* chore: fix grammar and typos

---------

Co-authored-by: unatasha8 <una.cogavin@ory.sh>
Co-authored-by: Patrik <zepatrik@users.noreply.github.com>
Co-authored-by: vinckr <vincent@ory.sh>
@vinckr @aeneasr
@alnr @unatasha8
fix: high-perf pooling doc (#2332)
be44bcd 
* fix: high-perf pooling doc

* chore: apply suggestion from code review

Co-authored-by: hackerman <3372410+aeneasr@users.noreply.github.com>

* chore: apply suggestion from code review

Co-authored-by: hackerman <3372410+aeneasr@users.noreply.github.com>

* chore: apply suggestions from code review

Co-authored-by: Arne Luenser <arne.luenser@ory.sh>

* chore: omit slop

---------

Co-authored-by: hackerman <3372410+aeneasr@users.noreply.github.com>
Co-authored-by: Arne Luenser <arne.luenser@ory.sh>
@ory-bot @unatasha8
chore(docs): update of OEL images (#2337)
bcd03b3 
chore(docs): update OEL image tag
@ory-bot @unatasha8
autogen(docs): generate cli docs
ed75f81
@ory-bot @unatasha8
autogen(docs): generate cli docs
a04e06a
@ory-bot @unatasha8
autogen(docs): generate cli docs
f6ab4ff
@deepakprabhakara @unatasha8
chore: added oel configuration schemas (#2279)
1af52f5 
* WIP

* temp hack for oathkeeper schema id

* temp hack for oathkeeper schema id

* revert schema urls

* - added new config pages for OEL
- updated dep
- resolve internal refs in ory resolvers correctly
@aeneasr @unatasha8
docs: bump to 99e1d24edde1c46372cb61a1839961fde59dba8b
e62c260
@vinckr @unatasha8
chore: clarify webhook config update (#2339)
f703129
@vinckr @unatasha8
fix: organizations docs (#2334)
c623f51
@pi1814 @unatasha8
feat: flutter quickstart (#2241)
cb07e32 
* flutter quickstart update

* updating docs to handle the .env misnaming in the pubspec and the port mismatch

* resolving default import issue with mdx for .env ref

* doc change for flutter quickstart

* fix: format

* update: pubspec.lock

* update: pubspec

* update: pubspec to higher version

* update: packages

* debug: test

* debug: test

* upgrade: flutter to latest version|

* remove: web renderer option for flutter
@K3das @unatasha8
feat: add kratos webhook header allowlist config details (#2100)
40b9b3f 
* feat: add kratos webhook header allowlist config details

Signed-off-by: Mia <m@yarn.network>

* fix: wording

Signed-off-by: Mia <m@yarn.network>

---------

Signed-off-by: Mia <m@yarn.network>
@unatasha8
chore: migration guide updates
10ad7ef
@vinckr vinckr merged commit 032c91a into master Nov 12, 2025
9 checks passed
@vinckr vinckr deleted the una-MigGuideUpdate branch November 12, 2025 21:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jonas-jonas jonas-jonas jonas-jonas approved these changes

@wassimoo wassimoo wassimoo approved these changes

@vinckr vinckr Awaiting requested review from vinckr vinckr is a code owner

@aeneasr aeneasr Awaiting requested review from aeneasr aeneasr is a code owner

@zepatrik zepatrik Awaiting requested review from zepatrik zepatrik is a code owner

@piotrmsc piotrmsc Awaiting requested review from piotrmsc piotrmsc is a code owner

@jhickmanit jhickmanit Awaiting requested review from jhickmanit

Assignees

@unatasha8 unatasha8

Labels

area/docs This issue affects Ory's documentation.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.