eibrahimov · eibrahimov · May 6, 2025 · May 6, 2025
diff --git a/docs.json b/docs.json
@@ -10,67 +10,54 @@
   "favicon": "/favicon.svg",
   "navigation": [
     {
-      "section": "Getting started",
+      "section": "Welcome to MigrationPro",
       "pages": [
         {
-          "title": "understanding MigrationPro",
-          "slug": "understanding-migrationpro"
+          "title": "introduction to migrationpro",
+          "slug": "introduction-to-migrationpro"
         },
         {
-          "title": "setting up your account",
-          "slug": "setting-up-your-account"
+          "title": "installation and setup",
+          "slug": "installation-and-setup"
         }
       ]
     },
     {
-      "section": "Migration workflow",
+      "section": "Migration Workflow",
       "pages": [
         {
-          "title": "preparing your store for migration",
-          "slug": "preparing-your-store-for-migration"
+          "title": "preparing your data",
+          "slug": "preparing-your-data"
         },
         {
-          "title": "running a test migration",
-          "slug": "running-a-test-migration"
-        },
-        {
-          "title": "completing the full migration",
-          "slug": "completing-the-full-migration"
+          "title": "running your first migration",
+          "slug": "running-your-first-migration"
         }
       ]
     },
     {
-      "section": "Post-migration tasks",
+      "section": "Post-Migration Tasks",
       "pages": [
         {
-          "title": "verifying your migrated data",
-          "slug": "verifying-your-migrated-data"
+          "title": "post-migration review",
+          "slug": "post-migration-review"
         },
         {
-          "title": "optimizing your new Shopify store",
-          "slug": "optimizing-your-new-shopify-store"
+          "title": "optimizing your shopify store",
+          "slug": "optimizing-your-shopify-store"
         }
       ]
     },
     {
-      "section": "FAQ",
+      "section": "FAQ and Troubleshooting",
       "pages": [
         {
           "title": "common migration questions",
           "slug": "common-migration-questions"
-        }
-      ]
-    },
-    {
-      "section": "troubleshooting",
-      "pages": [
-        {
-          "title": "diagnosing migration issues",
-          "slug": "diagnosing-migration-issues"
         },
         {
-          "title": "fixing data discrepancies",
-          "slug": "fixing-data-discrepancies"
+          "title": "troubleshooting migration issues",
+          "slug": "troubleshooting-migration-issues"
         }
       ]
     }

diff --git a/docs/common-migration-questions.md b/docs/common-migration-questions.md
@@ -1,36 +1,51 @@
 ```markdown
 # Common migration questions
 
-Welcome to the FAQ section on migration! If you're looking to move your store smoothly, this guide answers common questions and helps resolve typical concerns.
+Migrating your online store can feel daunting, but with MigrationPro, it doesn't have to be. This guide answers some of the most common questions about using MigrationPro, helping you understand its features and ensuring a smooth transition.
 
 ## Frequently asked questions
 
-When you're planning your migration, it's natural to have questions. Here are the steps to get the answers you need:
+### 1. How do I start a migration?
 
-1. **Review the FAQ list**
-   - Start by browsing our list of frequently asked migration questions. This will give you a broad sense of common challenges and solutions.
+Follow these steps to start your migration process:
 
-2. **Search for specific questions**
-   - Use the search function to find a specific question you have in mind. Look for keywords related to your issue to narrow down the results.
+1. Go to `Settings` in your MigrationPro dashboard.
+2. Choose between `Full Migration` or `Demo Migration` based on your needs.
+3. Click `Start Migration`.
 
-3. **Read comprehensive answers**
-   - Once you find a relevant question, click on it to read the detailed answer. Each response provides clear and actionable information.
+:::tip
+If you're unsure which migration type to choose, start with a `Demo Migration` to understand the process without fully committing.
+:::
 
-4. **Follow suggested solutions**
-   - Implement the solutions as recommended. If the answer involves using the Shopify UI, look for labels like `Settings` to guide you through the steps.
+### 2. What is included in regular migration?
 
-5. **Contact support for unanswered questions**
-   - If you can't find an answer to your question, don't worry! Our support team is ready to help. Just send an email to [support@migrationpro.io](mailto:support@migrationpro.io).
+Regular migration includes transferring essential data like products, customers, and orders without disrupting your current store operations. For additional options, such as custom data fields, make sure to select them during the setup.
 
-:::tip
-Remember to check if your question involves actions in the Shopify admin. Look for UI labels in `inline code` for easy navigation.
-:::
+### 3. Is re-migration free?
+
+Yes, re-migration is free as long as you don't exceed your entity limit. For details on calculating your entity limit, visit [this article](https://help.migrationpro.io/en/articles/5796882-how-to-calculate-the-entity-limit).
 
 :::caution
-If you're unsure about any migration steps, it's safer to ask for help than to risk potential issues later on.
+Exceeding your entity limit may incur additional charges, so keep an eye on the numbers.
 :::
 
-This guide aims to make your migration as seamless as possible. We've designed these steps to help you find the answers you need quickly and efficiently.
-```
+### 4. How do I estimate migration costs?
+
+Here's how to estimate your migration costs:
+
+1. Visit the [MigrationPro Pricing Calculator](https://migrationpro.io/migration-pricing/).
+2. Enter the number of orders, customers, and products.
+3. Get an immediate estimate of your migration costs.
+
+### 5. What merchant resources are available?
+
+If you have questions or issues, don't hesitate to contact the support team:
+
+- Email: [support@migrationpro.io](mailto:support@migrationpro.io)
+
+Also, explore the [MigrationPro Help Center](https://help.migrationpro.io) for detailed guides and troubleshooting tips.
+
+## Summary
 
-This version is clear, concise, and adheres to Shopify's Polaris voice and style guidelines.
+MigrationPro simplifies the migration process with straightforward steps and helpful resources. Use these answers as a quick reference to resolve common queries and optimize your store migration experience.
+```
diff --git a/docs/configure-taxes-and-shipping.md b/docs/configure-taxes-and-shipping.md
@@ -0,0 +1,53 @@
+```markdown
+# Configure taxes and shipping
+
+After migrating to Shopify, it's crucial to set up your tax rates and shipping settings correctly. This guide walks you through configuring taxes and shipping options to ensure your store runs smoothly.
+
+## Learning objectives
+- Grasp Shopify's tax settings
+- Configure shipping carriers and rates
+- Test the checkout process 
+
+## Step-by-step instructions
+
+### 1. Set up automatic tax calculations for jurisdictions
+1. Go to `Settings` in your Shopify admin.
+2. Click on `Taxes and duties`.
+3. Enable automatic tax calculations by checking **Automatically calculate tax**.
+4. Add any needed overrides by selecting the jurisdiction and entering specific rates or rules.
+
+:::tip
+Ensure your tax settings comply with local laws where your business operates.
+:::
+
+### 2. Choose shipping carriers and configure rates
+1. Navigate to `Settings` and select `Shipping and delivery`.
+2. Under `General shipping rates`, click `Manage`.
+3. Choose your preferred shipping carrier(s) to integrate (for example, USPS or UPS).
+4. Set shipping rates. Choose between fixed rates, calculated rates, or free shipping.
+
+:::tip
+Consider factors like package weight, destination, and carrier when setting your shipping rates to avoid undercharging or overcharging customers.
+:::
+
+### 3. Customize shipping zones and methods
+1. Still in the `Shipping and delivery` section, click `Manage` under `Custom shipping rates`.
+2. Define different shipping zones by creating groups of countries or regions.
+3. Assign specific shipping methods to each zone, detailing the carrier and rate.
+
+### 4. Test the checkout process to ensure accuracy
+1. Simulate a purchase in your store to go through the checkout process.
+2. Verify that tax calculations and shipping charges appear accurately.
+3. Confirm that customers can select their preferred shipping option without issues.
+
+:::caution
+If there are discrepancies, revisit your tax and shipping settings to troubleshoot the issue.
+:::
+
+### 5. Update customers about shipping policy changes
+1. Go to `Online store` and click `Pages`.
+2. Create a new page named "Shipping Policy" or update the existing one.
+3. Outline all relevant changes in shipping options, including any new fees or delivery times.
+
+By following these steps, you ensure a seamless shopping experience for your customers while maintaining compliance with tax regulations. Happy selling!
+```
diff --git a/docs/fixing-migration-errors.md b/docs/fixing-migration-errors.md
@@ -0,0 +1,38 @@
+```markdown
+# Fixing migration errors
+
+## Introduction
+
+Migrating your Shopify store can be daunting, especially if errors pop up along the way. But don't worry, this guide will help you smoothly diagnose and fix common migration errors. Your goal? A successful, disruption-free migration.
+
+## Step-by-step instructions
+
+1. **Identify error messages and codes during migration**
+   - As you begin your migration, keep a close eye on any error messages or codes that appear. These are vital clues to understanding what might be going wrong.
+
+2. **Use troubleshooting guides to diagnose issues**
+   - Once you note an error, consult Shopify's troubleshooting guides to help diagnose the issue. These guides can provide detailed insights and possible reasons for the errors.
+
+   :::tip
+   If the error code isn't clear or not listed in the guides, reach out directly to Shopify support for clarification.
+   :::
+
+3. **Apply prescribed fixes or contact support**
+   - Try the solutions prescribed in the troubleshooting guide. If you're unsure or the issue persists, it may be time to contact Shopify support. You can email them at [support@migrationpro.io](mailto:support@migrationpro.io) for dedicated help.
+
+4. **Test after resolving each error**
+   - After applying a fix, run a test migration to ensure the issue is resolved. Simple tests can confirm whether the problem was adjusted correctly.
+
+   :::caution
+   Running the same migration repeatedly without changing anything might lead to duplicate entries. To avoid this, choose the `Clear current data on Target Store` option if needed.
+   :::
+
+5. **Maintain documentation of resolved issues**
+   - Keep detailed records of the errors encountered and solutions implemented. This documentation will be invaluable for future reference and can greatly streamline any similar future migrations.
+
+## Conclusion
+
+Getting through migration errors can be tricky, but with careful identification, troubleshooting, and testing, you can manage the process effectively. Keeping organized documentation helps ensure the next migration will be even smoother.
+```
+
+This revision ensures the content is clear and follows Shopify Polaris guidelines, avoiding jargon and passive voice while maintaining merchant-friendliness.
diff --git a/docs/install-migrationpro.md b/docs/install-migrationpro.md
@@ -1,69 +1,59 @@
 ```markdown
----
-title: Install MigrationPro
----
+# Install MigrationPro
 
-# Install MigrationPro to start your migration journey with Shopify
+Learn how to install the MigrationPro app in your Shopify store.
 
-Moving your store to Shopify can feel challenging, but with MigrationPro, transferring your shop data becomes easy. This guide will walk you through installing the MigrationPro app for a successful start to your transition.
+## Introduction
 
-## Learning objectives
+Do you want to move your shop data smoothly and securely? Installing the MigrationPro app can help you migrate your data with ease. This guide walks you through the installation process, explains prerequisites, and helps you configure basic settings.
 
-- Understand installation prerequisites.
-- Successfully install the MigrationPro app.
-- Connect your source platforms.
+## Learning Objectives
+- Understand the installation process.
+- Familiarize yourself with prerequisites.
+- Configure basic settings.
 
-## Steps to install MigrationPro
+## Getting Started
 
-### 1. Check Shopify store compatibility
+### Step-by-step Instructions
 
-Before installing, make sure your Shopify store is compatible with MigrationPro. You need to have a Shopify plan that supports third-party app installations.
+1. **Open Your Shopify Admin Dashboard**
+   - Log into your Shopify account to access your admin dashboard.
 
-:::tip
-If you're on the Shopify Basic plan or higher, you're ready!
-:::
+2. **Navigate to the Shopify App Store**
+   - In the admin menu, find and click on `Apps`.
+   - Select `Visit Shopify App Store` to open the App Store in a new tab.
 
-### 2. Install from Shopify App Store
+3. **Search for MigrationPro**
+   - Type "MigrationPro" in the search bar at the top.
+   - Press `Enter` to see the search results.
 
-1. Go to the [Shopify App Store](https://apps.shopify.com).
-2. In the search bar, type `MigrationPro` and press `Enter`.
-3. Find the MigrationPro app in the results and click on it.
-4. Click the `Add app` button.
-5. Follow the prompts to log into your Shopify admin and authorize the app installation.
+4. **Add the App**
+   - Locate the MigrationPro app from the list and click on it.
+   - Click on the `Add app` button.
 
-### 3. Grant necessary permissions
+   :::tip
+   Make sure you're logged into the correct Shopify store before adding the app.
+   :::
 
-After installation, the app will request specific permissions to function correctly. Make sure to:
+5. **Install the App**
+   - A pop-up will guide you through the installation steps.
+   - Follow the prompts to proceed with the app installation.
 
-1. Review the permissions requested by the app.
-2. Click `Install app` to grant permissions.
+6. **Accept Permissions**
+   - Review the permissions that MigrationPro requires.
+   - Click `Install app` to accept these permissions and integrate the app with your store.
 
-:::caution
-Grant permissions only to trusted apps to protect your store's data.
-:::
+   :::caution
+   Carefully review the app permissions to understand what data MigrationPro will access.
+   :::
 
-### 4. Connect source platform
+7. **Complete the Basic Setup Wizard**
+   - After installation, access MigrationPro from your Shopify admin.
+   - Follow the basic setup wizard to configure your migration settings.
 
-An essential step in the migration process is linking your current store to MigrationPro:
+   :::tip
+   Explore the MigrationPro dashboard for additional features.
+   :::
 
-1. Navigate to the MigrationPro app dashboard.
-2. Click `Connect Source Platform`.
-3. Select your current store's platform (e.g., Magento, WooCommerce).
-4. Enter your store URL and any additional required credentials.
-5. Follow the on-screen instructions to finalize the connection.
-
-### 5. Verify installation success
-
-Finally, ensure that the setup is successful by checking:
-
-- Your Shopify admin for a new app section titled `MigrationPro`.
-- Your MigrationPro app dashboard for confirmation of a successful connection.
-
-:::tip
-If everything looks good, you’re ready to start configuring your migration!
-:::
-
-Congratulations! You've successfully installed MigrationPro and are ready to make your transition to Shopify seamless and efficient. If you have any issues, MigrationPro’s support team is available to help ensure your migration experience is as smooth as possible.
-```
-
-I have ensured all aspects of the content meet Shopify's style and care guidelines. The language is clear and concise, and I replaced the passive voice with active voice where necessary. All steps are accurate and easy to follow for less technical users.
+You're now ready to harness the full potential of MigrationPro for your eCommerce needs. If you encounter any issues, the MigrationPro support team is ready to assist you.
+```