Merge branch 'master' into una-MigGuideUpdate

Author: unatasha8

.github/ISSUE_TEMPLATE/BUG-REPORT.yml

@@ -25,10 +25,10 @@ body:
             Guidelines](https://github.com/ory/docs/blob/master/CONTRIBUTING.md)."
           required: true
         - label:
-            "I have joined the [Ory Community Slack](https://slack.ory.sh)."
+            "I have joined the [Ory Community Slack](https://slack.ory.com)."
         - label:
             "I am signed up to the [Ory Security Patch
-            Newsletter](https://www.ory.sh/l/sign-up-newsletter)."
+            Newsletter](https://www.ory.com/l/sign-up-newsletter)."
     id: checklist
     type: checkboxes
   - attributes:

.github/ISSUE_TEMPLATE/DESIGN-DOC.yml

@@ -36,10 +36,10 @@ body:
             Guidelines](https://github.com/ory/docs/blob/master/CONTRIBUTING.md)."
           required: true
         - label:
-            "I have joined the [Ory Community Slack](https://slack.ory.sh)."
+            "I have joined the [Ory Community Slack](https://slack.ory.com)."
         - label:
             "I am signed up to the [Ory Security Patch
-            Newsletter](https://www.ory.sh/l/sign-up-newsletter)."
+            Newsletter](https://www.ory.com/l/sign-up-newsletter)."
     id: checklist
     type: checkboxes
   - attributes:

.github/ISSUE_TEMPLATE/FEATURE-REQUEST.yml

@@ -29,10 +29,10 @@ body:
             Guidelines](https://github.com/ory/docs/blob/master/CONTRIBUTING.md)."
           required: true
         - label:
-            "I have joined the [Ory Community Slack](https://slack.ory.sh)."
+            "I have joined the [Ory Community Slack](https://slack.ory.com)."
         - label:
             "I am signed up to the [Ory Security Patch
-            Newsletter](https://www.ory.sh/l/sign-up-newsletter)."
+            Newsletter](https://www.ory.com/l/sign-up-newsletter)."
     id: checklist
     type: checkboxes
   - attributes:

.github/ISSUE_TEMPLATE/config.yml

@@ -9,6 +9,6 @@ contact_links:
       Please ask and answer questions here, show your implementations and
       discuss ideas.
   - name: Ory Chat
-    url: https://www.ory.sh/chat
+    url: https://www.ory.com/chat
     about:
       Hang out with other Ory community members to ask and answer questions.

.github/pull_request_template.md

@@ -24,7 +24,7 @@ Pull requests introducing new features, which do not have a design document link
 get merged.
 
 You can discuss changes with maintainers either in the Github Discussions in this repository or
-join the [Ory Chat](https://www.ory.sh/chat).
+join the [Ory Chat](https://www.ory.com/chat).
 -->
 
 ## Checklist
@@ -39,7 +39,7 @@ them, don't hesitate to ask. We're here to help! This is simply a reminder of wh
 - [ ] I have read the [security policy](../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](mailto:security@ory.sh)) from the maintainers to push the changes.
+      I confirm that I got approval (please contact [security@ory.com](mailto: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).
 

.prettierignore

@@ -16,3 +16,4 @@ docs/keto/reference/proto-api.mdx
 vendor
 code-examples/sdk/typescript/src/**/*.hbs
 **/.dart_tool
+**/*.jsonc

CODE_OF_CONDUCT.md

@@ -47,7 +47,7 @@ individual problems. If Ory open source software is used in production in a
 for-profit company or enterprise environment, we mandate a paid support contract
 where Ory is obligated under their service level agreements (SLAs) to offer a
 defined level of availability and responsibility. For more information about
-paid support please contact us at sales@ory.sh.
+paid support please contact us at sales@ory.com.
 
 ## Enforcement Responsibilities
 
@@ -73,7 +73,7 @@ representative at an online or offline event.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported to the community leaders responsible for enforcement at
-[office@ory.sh](mailto:office@ory.sh). All complaints will be reviewed and
+[office@ory.com](mailto:office@ory.com). All complaints will be reviewed and
 investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the

CONTRIBUTING.md

@@ -24,7 +24,7 @@
 
 _Please note_: We take Ory Documentation's security and our users' trust very
 seriously. If you believe you have found a security issue in Ory Documentation,
-please disclose it by contacting us at security@ory.sh.
+please disclose it by contacting us at security@ory.com.
 
 There are many ways in which you can contribute. The goal of this document is to
 provide a high-level overview of how you can get involved in Ory.
@@ -44,7 +44,7 @@ won't clash with Ory
 Documentation's direction. A great way to
 do this is via
 [Ory Documentation Discussions](https://github.com/orgs/ory/discussions)
-or the [Ory Chat](https://www.ory.sh/chat).
+or the [Ory Chat](https://www.ory.com/chat).
 
 ## FAQ
 
@@ -67,7 +67,7 @@ or the [Ory Chat](https://www.ory.sh/chat).
   [a Contributors License Agreement?](https://cla-assistant.io/ory/docs)
 
 - I would like updates about new versions of Ory Documentation.
-  [How are new releases announced?](https://www.ory.sh/l/sign-up-newsletter)
+  [How are new releases announced?](https://www.ory.com/l/sign-up-newsletter)
 
 ## How can I contribute?
 
@@ -109,15 +109,15 @@ to help out:
 
 ## Communication
 
-We use [Slack](https://www.ory.sh/chat). You are welcome to drop in and ask
+We use [Slack](https://www.ory.com/chat). You are welcome to drop in and ask
 questions, discuss bugs and feature requests, talk to other users of Ory, etc.
 
 Check out [Ory Documentation Discussions](https://github.com/orgs/ory/discussions). This is a great place for
 in-depth discussions and lots of code examples, logs and similar data.
 
 You can also join our community calls if you want to speak to the Ory team
 directly or ask some questions. You can find more info and participate in
-[Slack](https://www.ory.sh/chat) in the #community-call channel.
+[Slack](https://www.ory.com/chat) in the #community-call channel.
 
 If you want to receive regular notifications about updates to Ory Documentation,
 consider joining the mailing list. We will _only_ send you vital information on
@@ -139,7 +139,7 @@ to add your example or Ory-related project to the awesome-ory README.
 ## Contribute code
 
 Unless you are fixing a known bug, we **strongly** recommend discussing it with
-the core team via a GitHub issue or [in our chat](https://www.ory.sh/chat)
+the core team via a GitHub issue or [in our chat](https://www.ory.com/chat)
 before getting started to ensure your work is consistent with Ory Documentation's
 roadmap and architecture.
 
@@ -208,7 +208,7 @@ instructions please head over to the Ory Documentation
 ## Disclosing vulnerabilities
 
 Please disclose vulnerabilities exclusively to
-[security@ory.sh](mailto:security@ory.sh). Do not use GitHub issues.
+[security@ory.com](mailto:security@ory.com). Do not use GitHub issues.
 
 ## Code style
 
@@ -250,4 +250,4 @@ community a safe place for you and we've got your back.
 
 We welcome discussion about creating a welcoming, safe, and productive
 environment for the community. If you have any questions, feedback, or concerns
-[please let us know](https://www.ory.sh/chat).
+[please let us know](https://www.ory.com/chat).

README.md

@@ -1,11 +1,11 @@
 <h1 align="center">Ory Documentation</h1>
 
 <h4 align="center">
-    <a href="https://www.ory.sh/chat">Chat</a> |
-    <a href="https://www.ory.sh/l/sign-up-newsletter">Newsletter</a><br/><br/>
-    <a href="https://www.ory.sh/docs/">Documentation</a> |
+    <a href="https://www.ory.com/chat">Chat</a> |
+    <a href="https://www.ory.com/l/sign-up-newsletter">Newsletter</a><br/><br/>
+    <a href="https://www.ory.com/docs/">Documentation</a> |
     <a href="https://opencollective.com/ory">Support this project!</a><br/><br/>
-    <a href="https://www.ory.sh/jobs/">Work in Open Source, Ory is hiring!</a>
+    <a href="https://www.ory.com/jobs/">Work in Open Source, Ory is hiring!</a>
 </h4>
 
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
@@ -32,20 +32,26 @@
   - [Screenshots and videos](#screenshots-and-videos)
     - [Compressing images](#compressing-images)
     - [Recording and compressing videos](#recording-and-compressing-videos)
+  - [Ory Console](#ory-console)
+    - [Navigate to Ory Console Pages](#navigate-to-ory-console-pages)
   - [Testing](#testing)
   - [Formatting documentation](#formatting-documentation)
   - [Adding content to "Examples" page](#adding-content-to-examples-page)
   - [CLI and API reference - auto-generated content](#cli-and-api-reference---auto-generated-content)
+  - [CanonicalURL](#canonicalurl)
+    - [When to use CanonicalURL](#when-to-use-canonicalurl)
+    - [How to use CanonicalURL](#how-to-use-canonicalurl)
+    - [How to verify CanonicalURL is working](#how-to-verify-canonicalurl-is-working)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
 # Overview
 
 Ory documentation is the single source of truth for usage, implementation,
 configuration, and troubleshooting of the Ory Network and all projects of the
-[Ory Ecosystem](https://www.ory.sh/docs/ecosystem/projects/). The documentation
+[Ory Ecosystem](https://www.ory.com/docs/ecosystem/projects/). The documentation
 is best consumed through the
-[Ory documentation portal](https://www.ory.sh/docs/).
+[Ory documentation portal](https://www.ory.com/docs/).
 
 To see the source code of each of the projects, visit the project repository:
 
@@ -419,7 +425,7 @@ import VideoEmbed from '@site/src/components/VideoEmbed'
 You can use the `/current/` route to navigate users to their active Ory Network
 project. For example, to access the Custom UI settings for the active Ory
 Network project in the Console, you can link to:
-https://console.ory.sh/projects/current/ui
+https://console.ory.com/projects/current/ui
 
 When referencing a page of the Ory Console, use the
 `<ConsoleLink route="project..." />` component in MDX files.
@@ -540,3 +546,61 @@ The `cmd/clidoc/main.go` is the general path for all Ory projects.
 
 The command to generate the CLI docs can be found here:
 https://github.com/ory/x/blob/master/clidoc/generate.go#L96
+
+## CanonicalURL
+
+The `CanonicalURL` component specifies the authoritative URL for a page to
+search engines. Docusaurus adds trailing slashes to `index.mdx` files and files
+matching their parent directory names before Vercel's trailing slash removal
+takes effect. This means search engines can crawl both versions (with and
+without trailing slashes). The component ensures search engines know which
+version is canonical by explicitly setting a URL without a trailing slash.
+
+### When to use CanonicalURL
+
+Use this component on:
+
+- **Any `index.mdx` file**: These files serve content at their parent path
+  (e.g., `/api/index.mdx`)
+- **Files matching parent directory names**: When a file shares its parent
+  directory's name (e.g., `docs/kratos/organizations/organizations.mdx`)
+
+Common examples include:
+
+- Index Path (`/api/index.mdx`, `/elements/index.mdx`, `/identities/index.mdx`)
+- Matching parent directory names
+  (`docs/kratos/organizations/organizations.mdx`,
+  `docs/self-hosted/oel/monitoring/monitoring.mdx`)
+
+### How to use CanonicalURL
+
+Add the component at the beginning of your MDX file after the front matter:
+
+````md
+---
+id: your-page-id
+title: Your Page Title
+---
+
+```mdx-code-block
+import CanonicalURL from "@site/src/components/CanonicalUrl"
+
+<CanonicalURL path="your/canonical/path" />
+
+Your content here...
+```
+````
+
+### How to verify CanonicalURL is working
+
+1. Open the page in your browser
+2. Right-click and select "View Page Source" (not "Inspect")
+3. Search for `<link rel="canonical"` in the HTML
+4. Confirm the canonical URL exists and points to the correct path without
+   trailing slash
+
+Example:
+
+```html
+<link rel="canonical" href="https://www.ory.com/docs/kratos/organizations" />
+```

SECURITY.md

@@ -7,7 +7,7 @@ This policy outlines Ory's security commitments and practices for users across
 different licensing and deployment models.
 
 To learn more about Ory's security service level agreements (SLAs) and
-processes, please [contact us](https://www.ory.sh/contact/).
+processes, please [contact us](https://www.ory.com/contact/).
 
 ## Ory Network Users
 
@@ -53,4 +53,4 @@ processes, please [contact us](https://www.ory.sh/contact/).
 ## Reporting a Vulnerability
 
 For details on how to report security vulnerabilities, visit our
-[security policy documentation](https://www.ory.sh/docs/ecosystem/security).
+[security policy documentation](https://www.ory.com/docs/ecosystem/security).