Merge branch 'main' of https://github.com/port-labs/port-docs into update_doc_for_ingesting_all_repos

Author: emekanwaoma

docs/build-your-software-catalog/custom-integration/iac/pulumi/pulumi.md

@@ -1954,13 +1954,22 @@ To update an entity using Pulumi, update the existing `port.Entity` resource in
 
 It is also possible to start managing existing entities using Port's Pulumi provider, to begin managing an existing entity, add a new `port.Entity` resource to your code file and make the desired changes
 
-:::info
+After you add the resource definition, import the existing entity into your Pulumi stack so the provider manages it instead of trying to recreate it:
 
-Important notes about adding existing entities to the Pulumi provider:
+```shell showLineNumbers
+pulumi import port:index/entity:Entity myExistingEntity myBlueprint:myExistingEntity
+```
+
+- `port:index/entity:Entity` is the Pulumi type token for a Port entity.
+- `myExistingEntity` is the logical name you gave the resource in code.
+- `myBlueprint:myExistingEntity` follows the `<blueprintIdentifier>:<entityIdentifier>` format that matches the entity already in Port.
+
+Then run `pulumi up -y` to apply any changes.
+
+:::info Adding existing entities to the Pulumi provider
 
 - It is important to specify the `identifier` of the entity, otherwise Pulumi will create a new entity with an autogenerated identifier.
 - Port's Pulumi provider uses the [create/override](/build-your-software-catalog/custom-integration/api?update-strategy=create-override#usage) strategy, meaning for an existing entity, any properties not defined in the resource definition will be overridden with empty values.
-
 :::
 
 </TabItem>