reviewed the articles, added screenshots and diagrams

src/content/docs/project/import-export/import/import-tests-from-Allure-TestOps.md

@@ -10,40 +10,65 @@ head:
       content: Testomat.io, CSV, Allure TestOps, test import, migration, manual tests, automated tests, test management, custom CSV, convert tests.
 ---
 
-If you have existing tests in Allure TestOps and wish to migrate to Testomat.io, you can import tests from Allure TestOps using a customizable migration script for more advanced, tailored imports.
+Bringing tests from Allure TestOps into Testomat.io: export them from TestOps, run a script that converts the file, then upload what the script produced.
 
-## Where to Find a Migration Script
 
-Use the custom migration script to convert an Allure TestOps CSV file into Testomat.io’s CSV format. This method is recommended if you need customization or want to adjust the structure of your test cases during the migration process.
+![Export from Allure TestOps, convert the file with the script, then import it as Testomatio](./images/allure-migration-map.png)
 
-Click [migration script instructions](https://github.com/testomatio/migrate-allure) to access the script and get started.
+:::note
 
-## How to Import Tests into Testomat.io
+Allure TestOps files must be converted into the Testomat.io format before export.
 
-Once tests are converted and a new project is [created](https://docs.testomat.io/getting-started/#create-project),
+:::
 
-1. Navigate to the **Tests** page
-2. Click the **Import from Spreadsheet** button
+## Export from Allure TestOps
 
-![Import from Spreadsheet](./images/att1_494.png)
+1. Open your project in Allure TestOps.
+2. Export your test cases as a **CSV** file.
+3. Save the file on your computer.
 
-Once redirected to the **Imports** page
+## Convert the file
 
-3. From the dropdown menu, select the **Testomatio**
-4. Select the file generated by the migration script
-5. Click the **Create** button to complete the import
+The migration script turns your Allure CSV into a file Testomat.io can read. You can also use it to rename columns or restructure your cases on the way across.
 
-![Import tests](./images/att3_494.png)
+1. Open the [migration script instructions](https://github.com/testomatio/migrate-allure) on GitHub.
+2. Follow the setup steps there and run the script against your Allure file.
+3. Save the file the script produces. That is the one you upload.
 
-Or alternative way, if you're working in an existing project,
+## Import Allure TestOps file
 
-1. Navigate to the **Imports** page
-2. Click the **Import from CSV** button
+Start importing your tests to Testomat.io:
 
-![Import from CSV](./images/att2_494.png)
+1. Open your project and go to the **Tests** tab.
+2. Click the (`…`) menu.
+3. Choose **Import from other TMS**. 
 
-3. From the dropdown menu, select the **Testomatio**
-4. Select the file generated by the migration script
-5. Click the **Create** button to complete the import
+![Tests tab with the extra menu](./images/att1_436.png)
 
-![Import tests](./images/att3_494.png)
+In the **Imports** window:
+
+1. Click **Import**.
+2. Choose **Import from CSV**. A sidebar opens on the right.
+3. Choose **Testomatio** from the dropdown. 
+4. Click **Choose file**, select your exported and converted CSV.
+5. Click **Create**.
+
+![image Import Testomat](./images/att2_436_allure.png)
+
+:::note
+
+If you have not made a project yet, [create one first](https://docs.testomat.io/getting-started/#create-project).
+
+:::
+
+## If this doesn't work
+
+- **There is no Allure option in the dropdown.** There is not meant to be one. Pick **Testomatio** instead.
+- **The import fails.** Check that you uploaded the file the script produced, not your original Allure export.
+- **Something is still off.** Contact [support](https://docs.testomat.io/support) with your file attached.
+
+## Next steps
+
+* [Import from CSV/XLSX](https://docs.testomat.io/project/import-export/import/import-tests-from-csv-xlsx) - the column reference and every other supported format.
+* [Running Tests Manually](https://docs.testomat.io/project/runs/running-tests-manually) - run the tests you just imported and record the results.
+* [Labels and Custom Fields](https://docs.testomat.io/advanced/tags-labels/labels-and-custom-fields) - organize your imported tests by priority, type, or any Allure field.

src/content/docs/project/import-export/import/import-tests-from-qmetry.md

@@ -10,35 +10,60 @@ head:
       content: Testomat.io, CSV, QMetry, test import, QMetry migration, manual tests, automated tests, test management, custom XLS
 ---
 
-> If you have existing tests in Qmetry and wish to migrate to Testomat.io, you can import tests from QMetry using a customizable migration script for more advanced, tailored imports. 
+Bringing tests in QMetry into Testomat.io takes three steps: export them from QMetry, run a script that converts the file, then upload what the script produced.
 
-## Where to Find a Migration Script
+![Export from QMetry, convert the file with the script, then import it as Testomatio](./images/qmetry-migration-map.png)
 
-Use the custom migration script to convert a QMetry CSV file into Testomat.io’s CSV format.
-This method is recommended if you need customization or want to adjust the structure of your test cases during the migration process.
+:::note
 
-Click [migration script instructions](https://github.com/testomatio/migrate-qmetry) to access the script and get started.
+QMetry files must be converted into the Testomat.io format before export.
 
-## How to Import Tests into Testomat.io
+:::
 
-1. If you're creating a brand new project, the **Import from Spreadsheet** button will be available under the Test tab.
+## Export from QMetry
 
-![image Import from Spreadsheet button](./images/import_from_spreadsheet_button.png)
+1. Open your project in QMetry.
+2. Export your test cases as a **CSV** file.
+3. Save the file on your computer.
 
-2. If you're working in an existing project, open it in Testomat.io.
-3. Click the **Imports** tab.
-4. Click the **Import from CSV** button.
+## Convert the file
 
-![image Import from CSV button](./images/import_from_csv_button.png)
+The migration script turns your QMetry CSV into a file Testomat.io can read. You can also use it to rename columns or restructure your cases on the way across.
 
-5. From the dropdown menu, choose **Testomatio**.
-6. Select the file generated by the migration script.
-7. Click the **Create** button to complete the import.
+1. Open the [migration script instructions](https://github.com/testomatio/migrate-qmetry) on GitHub.
+2. Follow the setup steps there and run the script against your QMetry file.
+3. Save the file the script produces. That is the one you upload.
 
-![image Import Testomat](./images/import_testomat.png)
+## Import your QMetry file
 
+Start importing your tests to Testomat.io:
 
+1. Open your project and go to the **Tests** tab.
+2. Click the (`…`) menu.
+3. Choose **Import from other TMS**. 
 
+![Tests tab with the extra menu](./images/att1_436.png)
 
+In the **Imports** window:
 
+1. Click **Import**.
+2. Choose **Import from CSV**. A sidebar opens on the right.
+3. Choose **Testomatio** from the dropdown. 
+4. Click **Choose file**, select your exported and converted CSV.
+5. Click **Create**.
 
+![image Import Testomat](./images/att2_436_qmetry.png)
+
+Testomat.io reads the file, and your tests appear on the **Tests** page.
+
+## If this doesn't work
+
+- **There is no QMetry option in the dropdown.** There is not meant to be one. Pick **Testomatio** instead.
+- **The import fails.** Check that you uploaded the file the script produced, not your original QMetry export.
+- **Something is still off.** Contact [support](https://docs.testomat.io/support) with your file attached.
+
+## Next steps
+
+* [Import from CSV/XLSX](https://docs.testomat.io/project/import-export/import/import-tests-from-csv-xlsx) - the column reference and every other supported format.
+* [Running Tests Manually](https://docs.testomat.io/project/runs/running-tests-manually) - run the tests you just imported and record the results.
+* [Labels and Custom Fields](https://docs.testomat.io/advanced/tags-labels/labels-and-custom-fields) - organize your imported tests by priority, type, or any QMetry field.

src/content/docs/project/import-export/import/import-tests-from-testcaselabs.md

@@ -10,35 +10,66 @@ head:
       content: Testomat.io, CSV, TestCaseLabs, test import, TestCaseLabs migration, manual tests, automated tests, test management, custom XLS
 ---
 
-> If you have existing tests in TestCaseLabs and wish to migrate to Testomat.io, you can import tests from TestCaseLabs using a customizable migration script for more advanced, tailored imports. 
+Bringing tests from TestCaseLabs into Testomat.io takes three steps: export them from TestCaseLabs, run a script that converts the file, then upload what the script produced.
 
-## Import Tests from TestCaseLabs Using the Migration Script
+![Export from TestCaseLabs, convert the file with the script, then import it as Testomatio](./images/testcaselabs-migration-map.png)
 
-Use the custom migration script to convert a TestCaseLabs CSV file into Testomat.io’s CSV format.
-This method is recommended if you need customization or want to adjust the structure of your test cases during the migration process.
+:::note
 
-Click [migration script instructions](https://github.com/testomatio/migrate-testcaselabs) to access the script and get started.
+TestCaseLabs files must be converted into the Testomat.io format before export.
 
-## How to Import Tests into Testomat.io
+:::
 
-1. If you're creating a brand new project, the **Import from Spreadsheet** button will be available under the Test tab.
+## Export from TestCaseLabs
 
-![image Import from Spreadsheet button](./images/import_from_spreadsheet_button.png)
+1. Open your project in TestCaseLabs.
+2. Export your test cases as a **CSV** file.
+3. Save the file on your computer.
 
-2. If you're working in an existing project, open it in Testomat.io.
-3. Click the **Imports** tab.
-4. Click the **Import from CSV** button.
+## Convert the file
 
-![image Import from CSV button](./images/import_from_csv_button.png)
+The migration script turns your TestCaseLabs CSV into a file Testomat.io can read. You can also use it to rename columns or restructure your cases on the way across.
 
-5. From the dropdown menu, choose **Testomatio**.
-6. Select the file generated by the migration script.
-7. Click the **Create** button to complete the import.
+1. Open the [migration script instructions](https://github.com/testomatio/migrate-testcaselabs) on GitHub.
+2. Follow the setup steps there and run the script against your TestCaseLabs file.
+3. Save the file the script produces. That is the one you upload.
 
-![image Import Testomat](./images/import_testomat.png)
+## Import TestCaseLabs file
 
+Start importing your tests to Testomat.io:
 
+1. Open your project and go to the **Tests** tab.
+2. Click the (`…`) menu.
+3. Choose **Import from other TMS**. 
 
+![Tests tab with the extra menu](./images/att1_436.png)
 
+In the **Imports** window:
 
+1. Click **Import**.
+2. Choose **Import from CSV**. A sidebar opens on the right.
+3. Choose **Testomatio** from the dropdown. 
+4. Click **Choose file**, select your exported and converted CSV.
+5. Click **Create**.
 
+![image Import Testomat](./images/att2_436_testcaselabs.png)
+
+:::note
+
+If you have not made a project yet, [create one first](https://docs.testomat.io/getting-started/#create-project).
+
+:::
+
+Testomat.io reads the file, and your tests appear on the **Tests** page.
+
+## If this doesn't work
+
+- **There is no TestCaseLabs option in the dropdown.** There is not meant to be one. Pick **Testomatio** instead.
+- **The import fails.** Check that you uploaded the file the script produced, not your original TestCaseLabs export.
+- **Something is still off.** Contact [support](https://docs.testomat.io/support) with your file attached.
+
+## Next steps
+
+* [Import from CSV/XLSX](https://docs.testomat.io/project/import-export/import/import-tests-from-csv-xlsx) - the column reference and every other supported format.
+* [Running Tests Manually](https://docs.testomat.io/project/runs/running-tests-manually) - run the tests you just imported and record the results.
+* [Labels and Custom Fields](https://docs.testomat.io/advanced/tags-labels/labels-and-custom-fields) - organize your imported tests by priority, type, or any TestCaseLabs field.