WIP

Author: sivanel97

docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-files/_gitlab_integration_example_package_config.mdx

@@ -1,6 +1,6 @@
 <details>
 <summary><b>Integration mapping (click to expand)</b></summary>
-```yaml showLineNumbers
+```yaml showLineNumbers title="Integration mapping JSON file"
 resources:
   - kind: file
     selector:
@@ -23,4 +23,25 @@ resources:
             package: .item.key
             version: .item.value
 ```
+
+```yaml showLineNumbers title="Integration mapping YAML file"
+resources:
+  - kind: file
+    selector:
+      query: 'true'
+      files:
+        path: config.yml
+        repos:
+          - getport-labs/my-project
+    port:
+      entity:
+        mappings:
+        # Note that when parsing a YAML file, you should specify the index the parsed document.
+          identifier: .file.content.[0].identifier
+          title: .file.content.[0].title
+          blueprint: .file.content.[0].blueprint
+          properties:
+            slack_channel_name: .file.content.[0].properties.slack_channel_name
+            description: .file.content.[0].properties.description
+```
 </details>

docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/examples.md

@@ -164,8 +164,9 @@ You can use the following Port blueprint definitions and integration configurati
 
 <PackageConfig />
 
-The example will parse the `package.json` file in your repository and extract the dependencies into Port entities.  
-For more information about ingesting files and file contents, click [here](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/#ingest-files-from-your-repositories)
+The integration mapping example above demonstrates both a JSON file (`package.json`) and a YAML file (`config.yml`) configuration.
+The example will parse the file in your repository and extract the dependencies into Port entities.  
+For more information about ingesting files and file contents, click [here](/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/#ingest-files-from-your-repositories).