update fix paths

Author: louisachu

.github/workflows/deploy.yml

@@ -121,20 +121,20 @@ jobs:
       - name: Clean cache on stage
         if: needs.set-state.outputs.clean_cache == 'true' && needs.set-state.outputs.deploy_stage == 'true'
         run: |
-          bash .github/scripts/process-mds.sh cache stage ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"
+            bash .github/scripts/process-mds.sh cache stage ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"
 
       - name: Clean cache on prod
         if: needs.set-state.outputs.clean_cache == 'true' && needs.set-state.outputs.deploy_prod == 'true'
         run: |
-          bash .github/scripts/process-mds.sh cache prod ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"
+            bash .github/scripts/process-mds.sh cache prod ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"
 
       - name: Deploy to stage
         if: needs.set-state.outputs.deploy_stage == 'true'
         run: |
-          bash .github/scripts/process-mds.sh preview stage ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"
+            bash .github/scripts/process-mds.sh preview stage ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"
 
       - name: Deploy to prod
         if: needs.set-state.outputs.deploy_prod == 'true'
-        run: |
-          bash .github/scripts/process-mds.sh preview prod ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"
-          bash .github/scripts/process-mds.sh live prod ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"
+        run: |            
+            bash .github/scripts/process-mds.sh preview prod ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"
+            bash .github/scripts/process-mds.sh live prod ${{ needs.set-state.outputs.branch_short_ref }} "${{ needs.set-state.outputs.path_prefix }}"

normalizeLinks.js

@@ -17,20 +17,24 @@ function normalizeLinksInMarkdownFile(file, files) {
     let data = fs.readFileSync(file, 'utf8');
     const links = matchAll(data, new RegExp(linkPattern, "gm"));
     [...links].forEach(link => {
-
-        // ensure link includes file name and extension
+        const optionalPrefix = link[2] ?? '';
         const from = link[3] ?? '';
         let to = from;
-        if(link[2]?.endsWith('/') && to === '') {
-            to = 'index.md';
-        }
-        if(to.endsWith('/')) {
+
+        // ensure link includes file name and extension
+        if(to.endsWith('/') || optionalPrefix.endsWith('/') && !to) {
             to = `${to}index.md`
         }
-        if(!to.endsWith('.md')) {
+        if(!to.endsWith('.md') && to) {
             to = `${to}.md`;
         }
 
+        // ensure simplest relative path
+        // this removes trailing slash, so need to do this after the file name and extension checks above
+        const absolute = path.resolve(relativeToDir, to);
+        const relative = path.relative(relativeToDir, absolute);
+        to = relative;
+
         // ensure the link we constructed above exists
         const toExists = relativeFiles.find(file => to === file);
 

src/pages/guides/authentication/ServerToServerAuthentication/index.md

@@ -48,7 +48,7 @@ Read our OAuth Server-to-server credential implementation guide -
 
 <InlineAlert slots="text"/>
 
-The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jun 30, 2025. You must migrate to the new credential by **Jun 30, 2025**, to ensure your application continues functioning. [Learn more](../ServerToServerAuthentication/migration.md).
+The Service Account (JWT) credentials have been deprecated in favor of the OAuth Server-to-Server credentials. Your applications using the Service Account (JWT) credentials will stop working after Jun 30, 2025. You must migrate to the new credential by **Jun 30, 2025**, to ensure your application continues functioning. [Learn more](migration.md).
 
 Service Account (JWT) credentials rely on the JWT token exchange mechanism to generate access tokens. This credential's details include two secrets a `client_secret` and a `private.key` (part of a public certificate private key pair).
 

src/pages/guides/authentication/UserAuthentication/implementation.md

@@ -1,6 +1,6 @@
 # User Authentication Implementation Guide
 
-The following guide goes over finer implementation details for user authentication credentials. At the end of this guide is a list of recommended industry-standard OAuth2 libraries. Before proceeding, we recommend you familiarize yourself with the 3-legged OAuth flow in our  [user authentication guide](../UserAuthentication/index.md).
+The following guide goes over finer implementation details for user authentication credentials. At the end of this guide is a list of recommended industry-standard OAuth2 libraries. Before proceeding, we recommend you familiarize yourself with the 3-legged OAuth flow in our  [user authentication guide](index.md).
 
 ## User authentication credential types
 

src/pages/guides/plugins/plugin-distribution.md

@@ -2,7 +2,7 @@
 
 This guide provides instructions for distributing a Plugin created in Adobe Developer Console.
 
-For information on how to build a plugin, please being by reading the [plugin overview](../plugins/index.md).
+For information on how to build a plugin, please being by reading the [plugin overview](index.md).
 
 ## Select plugin project
 

src/pages/guides/services/services-add-api-key.md

@@ -60,7 +60,7 @@ To learn more about insights, begin by reading the [insights overview](../insigh
 
 ## Next steps
 
-With an API successfully added, you can follow the same workflow steps to add additional APIs, or return to the [services overview](../services/index.md) to select another type of service to add to your project.
+With an API successfully added, you can follow the same workflow steps to add additional APIs, or return to the [services overview](index.md) to select another type of service to add to your project.
 
 If you have completed development on your project and are ready to submit your application for approval, please read the [project approval guide](../projects/approval.md) to get started.
 

src/pages/guides/services/services-add-api-oauth-s2-s.md

@@ -99,6 +99,6 @@ To learn more about insights, begin by reading the [insights overview](../insigh
 
 ## Next steps
 
-With an API successfully added, you can follow the same workflow steps to add additional APIs, or return to the [services overview](../services/index.md) to select another type of service to add to your project.
+With an API successfully added, you can follow the same workflow steps to add additional APIs, or return to the [services overview](index.md) to select another type of service to add to your project.
 
 If you have completed development on your project and are ready to submit your application for approval, please read the [project approval guide](../projects/approval.md) to get started.

src/pages/guides/services/services-add-api-oauth-user-authentication.md

@@ -129,7 +129,7 @@ To learn more about insights, begin by reading the [insights overview](../insigh
 
 ## Next steps
 
-With an API successfully added, you can follow the same workflow steps to add additional APIs or return to the [services overview](../services/index.md) to select another type of service to add to your project.
+With an API successfully added, you can follow the same workflow steps to add additional APIs or return to the [services overview](index.md) to select another type of service to add to your project.
 
 If you have completed development on your project and are ready to submit your application for approval, please read the [project approval guide](../projects/approval.md) to get started.
 

src/pages/guides/services/services-add-api-oauth.md

@@ -2,4 +2,4 @@
 
 <InlineAlert slots="text"/>
 
-The new version of this guide is now available here - [Add API to project using OAuth User Authentication credentials](../services/services-add-api-oauth-user-authentication.md).
+The new version of this guide is now available here - [Add API to project using OAuth User Authentication credentials](services-add-api-oauth-user-authentication.md).

src/pages/guides/services/services-add-event.md

@@ -78,6 +78,6 @@ The *Debug Tracing* tab shows details related to recent requests and responses r
 
 ## Next steps
 
-Now that you have successfully added events to your project or workspace, you can follow this workflow again to add additional event registrations, or return to the [services overview](../services/index.md) to select another type of service to add to your project.
+Now that you have successfully added events to your project or workspace, you can follow this workflow again to add additional event registrations, or return to the [services overview](index.md) to select another type of service to add to your project.
 
 If you have completed development on your project and are ready to submit your application for approval, please read the [project approval guide](../projects/approval.md) to get started.