Remove some duplication and add screenshots

Author: nicholasyoder

premium/api-keys.md

@@ -1,65 +1,54 @@
-# API Keys & Secrets
+# API Credentials
 
-rotki premium uses API Keys and Secrets to connect your subscription to the rotki application. This guide explains how to create, manage, and secure your API credentials.
+rotki premium uses API credentials to connect your subscription to the rotki application. This guide explains how to create, manage, and secure your API credentials.
 
-## What are rotki Premium API Keys?
+## What are rotki Premium API Credentials?
 
-API Keys and Secrets are authentication credentials that:
+The API Key and Secret are authentication credentials that:
 
 - Link your rotki app to your premium subscription
 - Enable premium features in the application
 - Allow cloud backup and sync across devices
 - Identify your account for device limit management
 
-## Creating API Keys
-
-### First-Time Creation
+## Creating API Credentials
 
 After purchasing a subscription, you need to manually generate your API credentials:
 
 1. Go to your [subscription page](https://rotki.com/home/subscription)
-2. Navigate to the **API Keys** section
+2. Navigate to the **API Credentials** section
 3. Click the **Create** button
 4. Your credentials will be generated and displayed:
    - **API Key** - Your public identifier
    - **API Secret** - Your private authentication token
 5. You can view both credentials anytime from your subscription page
 
 ::: info Manual Generation Required
-API Keys and Secrets are not automatically created after payment. You must click the button to generate them for the first time.
+API Credentials are not automatically created after payment. You must click the button to generate them for the first time.
 :::
 
-### Where to Find Existing Keys
-
-You can view both your API Key and Secret anytime:
-
-1. Visit your [subscription page](https://rotki.com/home/subscription)
-2. Look in the API Keys section
-3. Both your API Key and Secret will be displayed
-
-## Using API Keys in the App
+## Using API Credentials in the App
 
 After creating your API credentials, add them to rotki:
 
 1. Open the rotki application
 2. Navigate to **API Keys** → **rotki Premium** in the sidebar
-3. Enter your **API Key**
-4. Enter your **API Secret**
-5. Click **Save**
+3. Enter your **API Key** and **API Secret**
+4. Click **Setup**
 
-For detailed app setup instructions, see the [API Keys Usage Guide](/usage-guides/api-keys#rotki-premium).
+![Set up rotki premium API key/secret pair in an existing account](/images/rotki_premium_set.png)
 
-## Managing API Keys
+## Managing API Credentials
 
-### Viewing Your Keys
+### Viewing Your Credentials
 
 From your [subscription page](https://rotki.com/home/subscription):
 
 - Both your API Key and Secret are always visible
 - You can copy them anytime you need
 - You can see when the key was created
 
-### Regenerating Keys
+### Regenerating Credentials
 
 If you need to create new credentials:
 
@@ -105,29 +94,11 @@ If you believe your API credentials have been exposed:
 
 ## API Keys and Device Limits
 
-Each premium tier has a device limit. When you add your API credentials to rotki:
-
-- The device is registered to your account
-- It counts toward your device limit
-- You can view and manage devices from the [devices page](/premium/devices)
-
-### Checking Device Usage
-
-From your [subscription page](https://rotki.com/home/subscription):
-
-- View current device count
-- See your tier's device limit
-- Access the [device list](https://rotki.com/home/devices) for details
-
-### Device Limit Exceeded
-
-If you reach your device limit:
+Each premium tier has a device limit. Each rotki app account where you add your
+API credentials is registered as a new device and counts toward your device limit.
 
-- New devices cannot authenticate
-- You'll see an error in the rotki app
-- Remove unused devices to free up slots
-
-See [Device Management](/premium/devices) for details on managing devices.
+For more information about managing your devices, device limits, and what to do
+when you exceed your device limit, see the [Device Management](/premium/devices) documentation.
 
 ## Troubleshooting
 
@@ -159,6 +130,10 @@ If premium features aren't activating:
 4. Try removing and re-adding the credentials
 5. Check the app logs for specific errors
 
+When premium is successfully activated in the app you should see a `rotki Premium is active` banner in the rotki Premium view.
+
+![Active rotki premium](/images/active_premium.png)
+
 ### Multiple Devices Not Syncing
 
 If sync isn't working across devices:

premium/devices.md

@@ -4,31 +4,15 @@ Manage devices using your rotki premium subscription and understand device limit
 
 ## What are Device Limits?
 
-Each rotki premium tier includes a limit on how many devices can use the same API Key and Secret simultaneously. This prevents unauthorized sharing while allowing you to use rotki on multiple devices you own.
+Each rotki premium tier includes a limit on how many devices can use the same rotki API credentials simultaneously. This prevents unauthorized sharing while allowing you to use rotki on multiple devices you own.
 
 Device limits vary by tier - check the [pricing page](https://rotki.com/pricing) for your tier's specific limit.
 
-## Accessing Device Management
+## Viewing Your Devices
 
 You can manage devices from two locations:
 
-### Website (rotki.com)
-
-Visit the [devices list page](https://rotki.com/home/devices) to manage devices online.
-
-### rotki Application
-
-Manage devices directly from the app:
-
-1. Open rotki
-2. Go to **Settings** → **Account** → **Premium Devices**
-3. View and manage all registered devices
-
-For detailed app instructions, see [Managing Premium Devices](/usage-guides/api-keys#managing-premium-devices).
-
-## Viewing Your Devices
-
-### On the Website
+**On the Website:**
 
 From the [devices list page](https://rotki.com/home/devices), you can see:
 
@@ -38,37 +22,33 @@ From the [devices list page](https://rotki.com/home/devices), you can see:
 - **Current count** - How many devices are active
 - **Your limit** - Maximum allowed for your tier
 
-### In the App
+**In the App:**
 
-From **Settings** → **Account** → **Premium Devices**:
+From **API Keys** → **rotki Premium**:
 
 - View all devices using your API credentials
 - See active device count vs. your limit
 - Identify which device you're currently using
 - Access device management options
 
-## Managing Device Names
-
-### Editing Device Names
-
-Device names help you identify which device is which (e.g., "Work Laptop", "Home Desktop", "MacBook Pro").
+![Premium devices management in the app](/images/premium_devices_app.png)
 
-**On the Website:**
+For detailed app instructions, see [Managing Premium Devices](/usage-guides/api-keys#managing-premium-devices).
 
-1. Go to the [devices list page](https://rotki.com/home/devices)
-2. Find the device you want to rename
-3. Click **Edit** or the edit icon
-4. Enter a new name
-5. Click **Save**
+## Editing Device Names
 
-**In the App:**
+Device names help you identify which device is which (e.g., "Work Laptop", "Home Desktop", "MacBook Pro").
 
-1. Go to **Settings** → **Account** → **Premium Devices**
+1. Navigate to **API Keys** → **rotki Premium** in the sidebar of the App
 2. Find the device to rename
 3. Click the edit option
 4. Enter a new name
 5. Save changes
 
+![Edit device name](/images/edit_device_name.png)
+
+![Edit device name dialog](/images/edit_device_name_dialog.png)
+
 ::: tip Naming Strategy
 Use descriptive names to easily identify devices:
 
@@ -122,7 +102,7 @@ If you try to use rotki on a new device after reaching your limit:
 - Premium features won't activate
 - The app may prompt you to manage devices
 
-### Resolving Device Limit Issues
+### What to Do When You Exceed the Limit
 
 To continue using rotki on a new device:
 
@@ -146,11 +126,7 @@ For detailed troubleshooting, see the [Usage Guide](/usage-guides/api-keys#devic
 
 ### When is a Device Registered?
 
-A device is registered when you:
-
-1. Add rotki premium API credentials to the app
-2. Successfully authenticate
-3. The app connects to rotki servers
+A device is registered when you add rotki premium API credentials to the app and successfully authenticate with rotki servers.
 
 ### How Devices are Identified
 
@@ -197,17 +173,9 @@ Avoid running rotki on multiple devices at the same time to prevent data sync co
 
 To see your tier's device limit:
 
-**Option 1: Subscription Page**
-
-Visit your [subscription page](https://rotki.com/home/subscription) to see your current tier and limits.
-
-**Option 2: Pricing Page**
-
-Check the [pricing page](https://rotki.com/pricing) for device limits across all tiers.
-
-**Option 3: Devices Page**
-
-The [devices list page](https://rotki.com/home/devices) shows your current count and limit.
+- Visit your [subscription page](https://rotki.com/home/subscription) to see your current tier and limits.
+- Check the [devices list page](https://rotki.com/home/devices) to view a list of all your current devices.
+- Navigate to **API Keys** → **rotki Premium** in the app to see your limit and a list of your current devices.
 
 ## Troubleshooting
 

premium/index.md

@@ -1,6 +1,6 @@
 # Premium Overview
 
-rotki premium is a paid subscription tier that unlocks additional features while supporting the ongoing development of rotki as an open-source project.
+rotki premium is a paid subscription with several tiers unlocking additional features depending on your needs while supporting the ongoing development of rotki as an open-source project.
 
 ## What is rotki Premium?
 
@@ -13,7 +13,7 @@ When you subscribe to rotki premium, you get:
 - Cloud backup and sync across multiple devices
 - Premium-only integrations (Monerium, Gnosis Pay, etc.)
 - Priority support
-- And more premium features
+- And more
 
 To see the complete list of premium features and current pricing, visit [rotki.com/products](https://rotki.com/products/).
 
@@ -33,28 +33,26 @@ See [Plans & Pricing](/premium/plans-and-pricing) for details.
 
 Choose from three payment methods:
 
-- **Crypto** - Manual transfer (non-renewable)
-- **Credit/Debit Card** - Auto-renewable via Braintree
+- **Crypto** - Manual transfer (renewal is done manually)
+- **Credit/Debit Card** - Auto-renewable
 - **PayPal** - Auto-renewable
 
 See [Payment Process](/premium/payment) for step-by-step instructions.
 
 ### 3. Generate Your API Keys
 
-After successful payment, you need to generate your API Key and Secret:
+After successful payment, generate your **API Key** and **API Secret**
+by clicking the **Create** button on your [subscription page](https://rotki.com/home/subscription).
 
-1. Go to your [subscription page](https://rotki.com/home/subscription)
-2. Click the button to create/generate API credentials
-3. Your API Key and Secret will be displayed
-4. You can view both credentials anytime on this page
-
-See [API Keys & Secrets](/premium/api-keys) for detailed instructions on creating and managing your keys.
+For detailed instructions, see [Creating API Keys](/premium/api-keys.html#creating-api-keys).
 
 ### 4. Add Keys to the App
 
-Input your API Key and Secret into the rotki application to activate premium features.
+Navigate to **API Keys** → **rotki Premium** in the rotki application and enter the
+**API Key** and **API Secret** generated in the last step to activate the premium features
+included in your subscription.
 
-For detailed instructions, see [API Keys in the Usage Guide](/usage-guides/api-keys#rotki-premium).
+For detailed instructions, see [Using API Keys in the App](/premium/api-keys.html#using-api-keys-in-the-app).
 
 ## Managing Your Premium Subscription
 

premium/payment.md

@@ -107,28 +107,16 @@ After completing payment:
 2. An invoice will be generated and available on your [subscription page](https://rotki.com/home/subscription)
 3. Your premium subscription is now active
 
-## Step 5: Generate Your API Keys
+## Step 5: Activate your subscription in the App
 
-After successful payment, you need to manually generate your API credentials:
+After successful payment, you need to manually generate your API credentials and
+add them to the rotki application.
 
-1. Go to your [subscription page](https://rotki.com/home/subscription)
-2. Click the **Create** button
-3. Your API Key and Secret will be generated and displayed
-4. You can view both credentials anytime from your subscription page
+1. Create your API key via the [subscription page](https://rotki.com/home/subscription)
+2. Navigate to **API Keys** → **rotki Premium** in the app and enter your **API Key** and **API Secret**
 
 See [API Keys & Secrets](/premium/api-keys) for detailed instructions.
 
-## Step 6: Activate Premium in the App
-
-Add your API credentials to the rotki application:
-
-1. Open rotki
-2. Navigate to **API Keys** → **rotki Premium**
-3. Enter your API Key and Secret
-4. Click **Save**
-
-See the [Usage Guide](/usage-guides/api-keys#rotki-premium) for detailed app setup instructions.
-
 ## Invoices and Receipts
 
 All payment invoices are automatically generated and stored in your account.

premium/referrals.md

@@ -15,8 +15,6 @@ You must have an active premium subscription to create and share referral codes.
 
 ## Creating a Referral Code
 
-### Create Your Code
-
 1. Go to your [subscription page](https://rotki.com/home/subscription)
 2. Navigate to the **Referral** section
 3. Click **Create**
@@ -25,8 +23,6 @@ You must have an active premium subscription to create and share referral codes.
 
 ## Using a Referral Code
 
-### For New Subscribers
-
 If someone shared a referral code with you:
 
 1. Go to the [pricing page](https://rotki.com/pricing)
@@ -55,7 +51,6 @@ For referees:
 - 10% discount applies to first subscription only
 - One referral code per subscription
 - Cannot be combined with other promotions (unless specified)
-- Discount is forfeited if subscription is immediately canceled
 
 ## Troubleshooting