Merge pull request #475 from kinde-oss/Fix/Python-links-and-headings

Fix/python links and headings. Small copyedit and cross reference fixes.

Author: clairekinde11

src/content/docs/developer-tools/sdks/backend/python-sdk-v1.mdx

@@ -8,6 +8,12 @@ relatedArticles:
   - 02d02820-92da-4721-9a91-222c9b095869
 ---
 
+<Aside type="warning">
+
+This SDK has been superseded by a [new version](/developer-tools/sdks/backend/python-sdk/).
+
+</Aside>
+
 The Kinde Python SDK allows developers to quickly and securely integrate a new or an existing Python application into the Kinde platform.
 
 ## Before you begin

src/content/docs/developer-tools/sdks/backend/python-sdk.mdx

@@ -17,7 +17,9 @@ The Kinde Python SDK allows developers to quickly and securely integrate a new o
 - Kinde Python SDK supports Python 3.9+
 - If you haven't already got a Kinde account, [register for free here](https://app.kinde.com/register) (no credit card required). Registering gives you a Kinde domain, which you need to get started, e.g. `yourapp.kinde.com`.
 
-For new projects, you can also find our [Starter Kit on GitHub](https://github.com/kinde-starter-kits/python-starter-kit).
+If you are using a previous version of Python, you may need to refer to the [previous v1 SDK](/developer-tools/sdks/backend/python-sdk-v1/).
+
+For new projects, you can find our [Starter Kit on GitHub](https://github.com/kinde-starter-kits/python-starter-kit).
 
 ## Install
 
@@ -27,19 +29,19 @@ Install [PIP](https://pip.pypa.io/en/stable/installation/) and then execute the
 pip install kinde-python-sdk
 ```
 
-### Environment Variables
+### Environment variables
 
-The Kinde Python SDK v2 uses environment variables for configuration. Here are all the supported variables:
+The Kinde Python SDK uses environment variables for configuration. Here are all the supported variables:
 
-#### Required Variables
+#### Required variables
 - `KINDE_CLIENT_ID` - Your application's client ID from Kinde
 - `KINDE_CLIENT_SECRET` - Your application's client secret from Kinde
 - `KINDE_REDIRECT_URI` - The callback URL where Kinde will redirect after authentication
 - `KINDE_HOST` - Your Kinde domain (e.g., `https://yourdomain.kinde.com`)
 - `KINDE_ISSUER_URL` - Your Kinde issuer URL (typically same as KINDE_HOST)
 - `GRANT_TYPE` - The OAuth grant type to use (e.g., `AUTHORIZATION_CODE_WITH_PKCE`)
 
-#### Optional Variables
+#### Optional variables
 - `KINDE_AUDIENCE` - The intended recipient of the access token (for API access)
 - `KINDE_CALLBACK_URL` - Alternative name for KINDE_REDIRECT_URI
 - `LOGOUT_REDIRECT_URL` - Where users are redirected after logout
@@ -149,7 +151,7 @@ oauth = OAuth(
 )
 ```
 
-### Manual Route Implementation
+### Manual route implementation
 
 If you prefer to implement the routes manually, here's how you can do it:
 
@@ -277,7 +279,7 @@ The Kinde Python SDK provides a simple way to check user permissions in your app
 from kinde_sdk.auth import permissions
 ```
 
-### Checking Permissions
+### Checking permissions
 
 To check if a user has a specific permission:
 
@@ -298,7 +300,7 @@ print(f"User belongs to organization: {all_permissions['orgCode']}")
 print("User permissions:", all_permissions["permissions"])
 ```
 
-### Practical Examples
+### Practical examples
 
 Here's how to use permissions in your application:
 
@@ -319,7 +321,7 @@ async def create_todo(todo_data: dict):
     # Create todo logic here...
 ```
 
-### Common Permission Patterns
+### Common permission patterns
 
 Here are some common permission patterns you might use:
 
@@ -343,15 +345,15 @@ Here are some common permission patterns you might use:
 
 For more information about setting up permissions in Kinde, see [User permissions](/manage-users/roles-and-permissions/user-permissions/).
 
-## Feature Flags
+## Feature flags
 
 The Kinde Python SDK provides a simple way to access feature flags from your application. First, import the feature flags module:
 
 ```python
 from kinde_sdk.auth import feature_flags
 ```
 
-### Getting Feature Flags
+### Getting feature flags
 
 To get a specific feature flag value:
 
@@ -379,7 +381,7 @@ for code, flag in all_flags.items():
     print(f"- {code}: {flag.value} ({flag.type})")
 ```
 
-### Practical Examples
+### Practical examples
 
 Here's how to use feature flags in your application:
 
@@ -414,7 +416,7 @@ async def create_competition(competition_data: dict):
     # Create competition logic here...
 ```
 
-### Feature Flag Types
+### Feature flag types
 
 The SDK supports the following feature flag types:
 
@@ -438,7 +440,7 @@ The SDK supports the following feature flag types:
 }
 ```
 
-### Common Use Cases
+### Common use cases
 
 ```python
 # Feature Toggles
@@ -463,7 +465,7 @@ The Kinde Python SDK provides a simple way to access user claims from your appli
 from kinde_sdk.auth import claims
 ```
 
-### Getting Claims
+### Getting claims
 
 To get a specific claim from the user's tokens:
 
@@ -489,7 +491,7 @@ for claim_name, claim_value in all_claims.items():
 id_token_claims = await claims.get_all_claims(token_type="id_token")
 ```
 
-### Practical Examples
+### Practical examples
 
 Here's how to use claims in your application:
 
@@ -515,7 +517,7 @@ async def protected_endpoint():
     return {"message": "Access granted"}
 ```
 
-### Common Claims
+### Common claims
 
 Here are some common claims you might want to access:
 
@@ -538,7 +540,7 @@ Here are some common claims you might want to access:
 "org_id"
 ```
 
-### Token Types
+### Token types
 
 The SDK supports two types of tokens:
 
@@ -632,7 +634,7 @@ Once the user has successfully authenticated, you'll get a JWT and possibly a re
 
 The Kinde Python SDK provides a Management API client for interacting with Kinde's management endpoints. This allows you to programmatically manage users, organizations, and other resources.
 
-### Getting Started
+### Getting started
 
 To use the Management API, you'll need to initialize the client with your Kinde credentials:
 
@@ -648,7 +650,7 @@ oauth = OAuth(
 management = oauth.get_management()
 ```
 
-### Available Endpoints
+### Available endpoints
 
 The Management API provides methods for common operations on resources. Here are some examples:
 
@@ -676,7 +678,7 @@ updated_user = await management.update_user(
 await management.delete_user(user_id="user_123")
 ```
 
-### Organization Management
+### Organization management
 
 ```python
 # List organizations
@@ -700,7 +702,7 @@ updated_org = await management.update_organization(
 await management.delete_organization(org_id="org_123")
 ```
 
-### Error Handling
+### Error handling
 
 The Management API methods will raise exceptions for API errors. It's recommended to handle these appropriately:
 
@@ -712,7 +714,7 @@ except Exception as e:
     print(f"Error: {e}")
 ```
 
-### Token Management
+### Token management
 
 The Management API client automatically handles token management, including:
 - Token acquisition
@@ -722,7 +724,7 @@ The Management API client automatically handles token management, including:
 
 You don't need to manage tokens manually - the client handles this for you.
 
-### Best Practices
+### Best practices
 
 1. Always use async/await when calling Management API methods
 2. Handle API errors appropriately