update secret import docs

docs/documentation/platform/secret-reference.mdx

@@ -36,14 +36,17 @@ Without proper permissions, the final secret value may be incomplete.
 
 ## Import entire folders 
 
-You can import or link another environment's folder to your dashboard to inherit its secrets. This is useful when you need to share secrets across multiple environments.
+While secret referencing effectively minimizes duplication, there might be instances where you need to import or replicate an entire folder's secrets into another. This can be achieved using the 'Import' feature.
 
-To add an import/link, just click on `Secret Link` button and provide an `environment` and `secret path` to which the secrets must be pulled. 
+This feature allows you to link secrets from one environment/folder into another environment/folder. It proves beneficial when you have common secrets that need to be available across multiple environments/folders.
+
+To add an import, simply click on the `Add import` button and provide the environment and secret path from where the secrets should be imported.
 
 ![secret import change order](../../images/secret-import-add.png)
 
-The import hierarchy is "last one wins." This means that the order in which you import matters. The last folder you import will override the secrets from any previous folders. Additionally, any secrets you define in your dashboard will override the secrets from any imported folders.
+The hierarchy of importing secrets is governed by a "last-one-wins" rule. This means the sequence in which you import matters - the final folder imported will override secrets from any prior folders. 
+Moreover, any secrets you define directly in your environment will take precedence over secrets from any imported folders.
 
-You can change the order by dragging and positioning according using the `Change Order` drag handle.
+You can modify this sequence by dragging and rearranging the folders using the `Change Order` drag handle.
 
-![secret import change order](../../images/secret-import-change-order.png
+![secret import change order](../../images/secret-import-change-order.png)