Merge branch 'Fix/Folder-level-redirects' of https://github.com/kinde-oss/documentation into Fix/Folder-level-redirects

Author: clairekinde11

src/components/ContributionGuides.astro

@@ -1,5 +1,25 @@
 ---
 import {Icon} from "astro-icon/components";
+import { getEntry } from 'astro:content';
+
+// Get the current page path and always use docs.kinde.com as the hostname
+const currentPath = Astro.url.pathname;
+const productionUrl = `https://docs.kinde.com${currentPath}`;
+const chatGptUrl = `https://chat.openai.com/?q=${encodeURIComponent(`Can you summarize this page: ${productionUrl}`)}`;
+
+// Get the raw markdown content
+let rawMarkdown = '';
+try {
+  // Convert the path to the content ID (remove leading slash and trailing slash)
+  const contentId = currentPath.replace(/^\/|\/$/g, '');
+  const entry = await getEntry('docs', contentId);
+  if (entry) {
+    const body = await entry.body;
+    rawMarkdown = body || '';
+  }
+} catch (error) {
+  console.error('Error getting markdown content:', error);
+}
 ---
 
 <aside
@@ -12,4 +32,125 @@ import {Icon} from "astro-icon/components";
     <Icon name="book" size={16} />
     <h3 class="text-sm font-medium dark:!font-normal">Contribute</h3>
   </a>
+  
+  <a
+    href={chatGptUrl}
+    target="_blank"
+    rel="noopener noreferrer"
+    class={`flex items-center justify-start gap-1 mt-4 text-kinde-grey-900 hover:opacity-90 dark:text-white plausible-event-name=Open+with+ChatGPT plausible-event-url=${currentPath}`}
+  >
+    <Icon name="talk-1" size={16} />
+    <h3 class="text-sm font-medium dark:!font-normal">Open with ChatGPT</h3>
+  </a>
+  
+  <button
+    id="copy-markdown-button"
+    class={`flex items-center justify-start gap-1 mt-4 text-kinde-grey-900 hover:opacity-90 dark:text-white bg-transparent border-none cursor-pointer w-full text-left p-0 plausible-event-name=Copy+for+AI plausible-event-url=${currentPath}`}
+    data-markdown={rawMarkdown}
+  >
+    <Icon name="sparkle" size={16} />
+    <h3 class="text-sm font-medium dark:!font-normal">Copy for AI</h3>
+  </button>
 </aside>
+
+<script>
+  document.getElementById('copy-markdown-button')?.addEventListener('click', async function() {
+    try {
+      // Get the raw markdown from the data attribute
+      const rawMarkdown = this.getAttribute('data-markdown');
+      if (!rawMarkdown) {
+        console.error('No markdown content available');
+        return;
+      }
+
+      // Get the page title
+      const titleElement = document.querySelector('h1');
+      const title = titleElement?.textContent || 'Kinde Documentation';
+      
+      // Create markdown content with metadata
+      const markdownContent = `# ${title}
+
+Source: ${window.location.href}
+
+${rawMarkdown}
+
+---
+*This content was copied from the Kinde documentation page. You can use this markdown content with any AI LLM to get help with this documentation.*`;
+
+      // Copy to clipboard
+      await navigator.clipboard.writeText(markdownContent);
+      
+      // Show success notification
+      const button = this as HTMLButtonElement;
+      const titleElement2 = button.querySelector('h3');
+      if (titleElement2) {
+        const originalText = titleElement2.textContent;
+        titleElement2.textContent = 'Markdown copied!';
+        
+        // Show a notification
+        const notification = document.createElement('div');
+        notification.style.cssText = `
+          position: fixed;
+          top: 20px;
+          right: 20px;
+          background: #10b981;
+          color: white;
+          padding: 12px 16px;
+          border-radius: 8px;
+          font-size: 14px;
+          z-index: 10000;
+          max-width: 300px;
+          box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+        `;
+        notification.innerHTML = `
+          <div style="font-weight: 600; margin-bottom: 4px;">Markdown copied to clipboard!</div>
+          <div style="font-size: 12px;">You can now paste this into any AI LLM.</div>
+        `;
+        document.body.appendChild(notification);
+        
+        // Remove notification after 4 seconds
+        setTimeout(() => {
+          if (notification.parentNode) {
+            notification.parentNode.removeChild(notification);
+          }
+        }, 4000);
+        
+        // Reset button text after 3 seconds
+        setTimeout(() => {
+          if (titleElement2) {
+            titleElement2.textContent = originalText;
+          }
+        }, 3000);
+      }
+      
+    } catch (error) {
+      console.error('Error copying markdown:', error);
+      // Show error notification
+      const notification = document.createElement('div');
+      notification.style.cssText = `
+        position: fixed;
+        top: 20px;
+        right: 20px;
+        background: #ef4444;
+        color: white;
+        padding: 12px 16px;
+        border-radius: 8px;
+        font-size: 14px;
+        z-index: 10000;
+        max-width: 300px;
+        box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+      `;
+      notification.innerHTML = `
+        <div style="font-weight: 600; margin-bottom: 4px;">Error copying markdown</div>
+        <div style="font-size: 12px;">Please try again.</div>
+      `;
+      document.body.appendChild(notification);
+      
+      setTimeout(() => {
+        if (notification.parentNode) {
+          notification.parentNode.removeChild(notification);
+        }
+      }, 4000);
+    }
+  });
+</script>

src/content/docs/authenticate/about-auth/about-authentication.mdx

@@ -12,6 +12,19 @@ relatedArticles:
 app_context:
   - m: settings
     s: authentication
+description: Learn about Kinde's authentication methods including password, passwordless, social sign-in, and enterprise connections.
+metadata:
+  topics: [authenticate]
+  sdk: []
+  languages: []
+  audience: [developer, product-manager]
+  complexity: beginner
+  keywords: [authentication, sign up, sign in, password, passwordless, social login, enterprise, SSO]
+  updated: 2025-01-16
+featured: false
+deprecated: false
+ai-summary: >
+  Comprehensive overview of Kinde's authentication methods including password, passwordless, social sign-in, and enterprise connections with multi-domain support.
 ---
 
 Kinde makes authentication easy by providing a range of methods to choose from.

src/content/docs/authenticate/about-auth/authentication-methods.mdx

@@ -10,6 +10,19 @@ relatedArticles:
   - 0145d1ce-564e-4c28-820f-2f126abbfe3a
   - a5225946-27ad-41c0-a3c1-9a6d735e3efb
   - 66b2a627-b24a-4ccf-a792-80a6a9fe35ef
+description: Detailed guide to all authentication methods supported by Kinde including email, phone, social, and enterprise authentication.
+metadata:
+  topics: [authenticate]
+  sdk: []
+  languages: []
+  audience: [developer, product-manager]
+  complexity: beginner
+  keywords: [email authentication, password, passwordless, phone auth, SMS, social login, enterprise SSO, OTP]
+  updated: 2025-01-16
+featured: false
+deprecated: false
+ai-summary: >
+  Complete guide to Kinde's authentication methods including email/password, passwordless OTP, phone SMS authentication, social providers, and enterprise SSO connections.
 ---
 
 Kinde supports the following authentication methods.

src/content/docs/authenticate/about-auth/identity-and-verification.mdx

@@ -8,6 +8,19 @@ relatedArticles:
   - d5ab49ac-bf16-487a-b1a1-e07f68e42be7
   - 776166a5-eebd-42be-a695-36eaafba0823
   - 8b9376c4-308c-4eaa-a990-606fb8bbf770
+description: Understanding how user identity and verification works in Kinde, including identity types, trusted providers, and verification processes.
+metadata:
+  topics: [authenticate]
+  sdk: []
+  languages: []
+  audience: [developer, security-engineer]
+  complexity: intermediate
+  keywords: [user identity, verification, trusted providers, email verification, social identity, enterprise identity, profile sync]
+  updated: 2025-01-16
+featured: false
+deprecated: false
+ai-summary: >
+  Comprehensive guide to user identity management in Kinde covering identity types, verification processes, trusted providers, and profile synchronization.
 ---
 
 A key part of making authentication secure, is through verification of user identities. Verification usually happens at sign up, to ensure the person signing up exists and is the intended person gaining access to your app or project.

src/content/docs/authenticate/about-auth/user-communication.mdx

@@ -7,6 +7,19 @@ relatedArticles:
   - 0222489b-3478-48a7-a5c9-c99c6044f0e9
   - c4182a6d-64ca-4c82-ba33-e5fc5d8b8cad
   - e519f56a-603a-44dd-a946-3aaf6fb256ce
+description: Learn about how Kinde communicates with users through emails and SMS for authentication purposes.
+metadata:
+  topics: [authenticate]
+  sdk: []
+  languages: []
+  audience: [developer, product-manager]
+  complexity: beginner
+  keywords: [user communication, email, SMS, OTP, verification, Twilio, webhooks]
+  updated: 2025-01-16
+featured: false
+deprecated: false
+ai-summary: >
+  Guide to Kinde's user communication methods including authentication emails, SMS OTP messages, and webhook integration for custom notifications.
 ---
 
 Kinde only sends emails or texts to users as part of the authentication experience, for example to send one-time passwords or to verify user identity for self-sign-up.

src/content/docs/authenticate/auth-guides/enterprise-connections-identity.mdx

@@ -6,6 +6,19 @@ sidebar:
 relatedArticles:
   - fcf28a71-c3a8-4474-9564-ad089d3f2105
   - e519f56a-603a-44dd-a946-3aaf6fb256ce
+description: Understanding why Kinde enforces one enterprise identity per user for security, account integrity, and simplified tenant management.
+metadata:
+  topics: [authenticate]
+  sdk: []
+  languages: []
+  audience: [developer, security-engineer, enterprise-admin]
+  complexity: intermediate
+  keywords: [enterprise identity, SSO, identity provider, IdP, security, account integrity, tenant management]
+  updated: 2025-01-16
+featured: false
+deprecated: false
+ai-summary: >
+  Security-focused guide explaining why Kinde enforces one enterprise identity per user to prevent conflicts, ensure account integrity, and simplify tenant management.
 ---
 
 At Kinde, each user can only have one enterprise identity provider (IdP) connection as part of their user profile. This is because we want to keep things simple, secure, and reliable.

src/content/docs/authenticate/auth-guides/mixed-b2b-b2c.mdx

@@ -9,6 +9,19 @@ relatedArticles:
   - 0145d1ce-564e-4c28-820f-2f126abbfe3a
   - 720fcdda-daa6-4dff-ad2d-177af555e6bb
   - 2c58dabc-fe5c-4919-ade7-4caab8da47e8
+description: Complete guide to setting up unified authentication for mixed B2B and B2C businesses using Kinde Scale plan features.
+metadata:
+  topics: [authenticate]
+  sdk: []
+  languages: []
+  audience: [developer, product-manager, enterprise-admin]
+  complexity: advanced
+  keywords: [B2B, B2C, mixed authentication, enterprise connections, SAML, organizations, home realm discovery]
+  updated: 2025-01-16
+featured: false
+deprecated: false
+ai-summary: >
+  Comprehensive guide for setting up unified authentication supporting both B2B enterprise connections and B2C passwordless authentication in a single application.
 ---
 
 If you have an app or site that supports a mix of business customers and direct customers, this guide shows you how to set up authentication in Kinde to meet both these needs.

src/content/docs/authenticate/auth-guides/pass-params-idp.mdx

@@ -7,6 +7,19 @@ relatedArticles:
   - fcf28a71-c3a8-4474-9564-ad089d3f2105
   - b663dbde-2045-4f51-bab4-84d0c9fbe15b
   - 50284476-2442-414c-af20-01ed3ef4ca4e
+description: Learn how to pass static and dynamic parameters to identity providers during authentication for improved user experience.
+metadata:
+  topics: [authenticate]
+  sdk: []
+  languages: [json]
+  audience: [developer, integration-engineer]
+  complexity: intermediate
+  keywords: [upstream params, identity provider, OAuth 2.0, SAML, login_hint, prompt, account switcher]
+  updated: 2025-01-16
+featured: false
+deprecated: false
+ai-summary: >
+  Technical guide for passing static and dynamic parameters to identity providers during OAuth 2.0 and SAML authentication flows.
 ---
 
 You can pass provider-specific parameters to an Identity Provider (IdP) during authentication. These are also known as 'upstream params'. The values your pass can either be static per connection or dynamic per user.

src/content/docs/authenticate/authentication-methods/email-authentication.mdx

@@ -7,6 +7,19 @@ relatedArticles:
   - 26e55a64-13dd-4c7b-b9ad-e7595903ddc8
   - c4bc277a-5ec7-418c-ba1c-4d58c9ddfd7d
   - 2aa551b8-06c0-4947-bd4b-d643c77ed224
+description: Comprehensive overview of email authentication methods including verification, account linking, and customization options.
+metadata:
+  topics: [authenticate]
+  sdk: []
+  languages: []
+  audience: [developer, product-manager]
+  complexity: beginner
+  keywords: [email authentication, email verification, account linking, Gravatar, login_hint, profile pictures]
+  updated: 2025-01-16
+featured: false
+deprecated: false
+ai-summary: >
+  Complete guide to email authentication covering verification processes, account linking, and customization options for email-based sign-in.
 ---
 
 The most common application signup and sign in method for users is email. Kinde supports a number of approaches to email authentication.

src/content/docs/authenticate/authentication-methods/email-deliverability.mdx

@@ -6,6 +6,19 @@ sidebar:
 relatedArticles:
   - 0222489b-3478-48a7-a5c9-c99c6044f0e9
   - 90134c89-16e4-4981-b988-b0cb4f1722c5
+description: Guide to email deliverability best practices including custom email senders, authentication records, and troubleshooting delivery issues.
+metadata:
+  topics: [authenticate]
+  sdk: []
+  languages: []
+  audience: [developer, product-manager, devops]
+  complexity: intermediate
+  keywords: [email deliverability, SMTP, SPF, DMARC, DKIM, email authentication, spam prevention]
+  updated: 2025-01-16
+featured: false
+deprecated: false
+ai-summary: >
+  Comprehensive guide to email deliverability including custom sender setup, authentication records, and troubleshooting common delivery issues.
 ---
 
 Kinde encourages users to configure their own email sender, so that verification and other emails are sent form your own business, and not Kinde.