Refactor docs: Moved headers and summaries to the config & blueprint files

dennis-bilson-port · dennis-bilson-port · commit 9fa0154e1865 · 2025-10-20T12:00:17.000Z
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-files/_gitlab_integration_example_package_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-files/_gitlab_integration_example_package_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Package blueprint</summary>
 ```json showLineNumbers
 {
   "identifier": "package",
@@ -26,4 +28,5 @@
   "aggregationProperties": {},
   "relations": {}
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-files/_gitlab_integration_example_package_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-files/_gitlab_integration_example_package_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary> Integration mapping </summary>
 ```yaml showLineNumbers
 resources:
   - kind: file
@@ -21,3 +23,4 @@ resources:
             package: .item.key
             version: .item.value
 ```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_integration_example_folder_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_integration_example_folder_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Folder blueprint</summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabFolder",
@@ -32,4 +34,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_integration_example_folder_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-folders/_gitlab_integration_example_folder_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary> Integration mapping </summary>
 ```yaml showLineNumbers
 resources:
   - kind: project
@@ -40,4 +42,5 @@ resources:
             readme: file://README.md
           relations:
             project: .references.full | gsub("!.+"; "")
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_exporter_example_group_repository_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_exporter_example_group_repository_port_app_config.mdx
@@ -1,7 +1,5 @@
 <details>
-
 <summary> Integration mapping </summary>
-
 ```yaml showLineNumbers
 deleteDependentEntities: true
 createMissingRelatedEntities: true
@@ -43,5 +41,4 @@ resources:
               .path_with_namespace | gsub(" "; "") | split("/") | .[:-1] |
               join("/")
 ```
-
 </details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Group blueprint</summary>
 ```json
 {
   "identifier": "gitlabGroup",
@@ -39,4 +41,5 @@
   "aggregationProperties": {},
   "relations": {}
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary> Integration mapping </summary>
 ```yaml showLineNumbers
 resources:
   - kind: group
@@ -13,4 +15,5 @@ resources:
             url: .web_url
             visibility: .visibility
             description: .description
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_members_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_members_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Group with members blueprint</summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabGroup",
@@ -46,4 +48,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_members_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-groups/_gitlab_integration_example_group_members_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary> Integration mapping </summary>
 ```yaml showLineNumbers
 resources:
   - kind: group-with-members
@@ -15,4 +17,5 @@ resources:
             description: .description
           relations:
             gitlabMembers: .__members | map(.username)
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-issues/_gitlab_integration_example_issue_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-issues/_gitlab_integration_example_issue_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Issue blueprint</summary>
 ```json
 {
   "identifier": "gitlabIssue",
@@ -57,4 +59,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-issues/_gitlab_integration_example_issue_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-issues/_gitlab_integration_example_issue_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary> Integration mapping </summary>
 ```yaml showLineNumbers
 resources:
   - kind: project
@@ -37,4 +39,5 @@ resources:
             labels: "[.labels[]]"
           relations:
             project: .references.full | gsub("#.+"; "")
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-jobs/_gitlab_integration_example_job_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-jobs/_gitlab_integration_example_job_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Job blueprint</summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabJob",
@@ -59,4 +61,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-members/_gitlab_integration_example_member_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-members/_gitlab_integration_example_member_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Member blueprint</summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabMember",
@@ -35,4 +37,5 @@
   "aggregationProperties": {},
   "relations": {}
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-members/_gitlab_integration_example_member_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-members/_gitlab_integration_example_member_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Integration Mapping</summary>
 ```yaml showLineNumbers
 resources:
   - kind: member
@@ -14,4 +16,5 @@ resources:
             state: .state
             email: .email
             created_by: .created_by.name
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-merge-requests/_gitlab_integration_example_merge_request_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-merge-requests/_gitlab_integration_example_merge_request_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Merge request blueprint</summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabMergeRequest",
@@ -71,4 +73,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-merge-requests/_gitlab_integration_example_merge_request_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-merge-requests/_gitlab_integration_example_merge_request_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary> Integration configuration</summary>
 ```yaml showLineNumbers
 resources:
   - kind: project
@@ -44,4 +46,5 @@ resources:
             reviewers: .reviewers | map(.name)
           relations:
             project: .references.full | gsub("!.+"; "")
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-pipelines/_gitlab_integration_example_pipeline_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-pipelines/_gitlab_integration_example_pipeline_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Pipeline blueprint</summary>
 ```json showLineNumbers
 {
   "identifier": "gitlabPipeline",
@@ -50,4 +52,5 @@
     }
   }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-pipelines/_gitlab_integration_example_pipeline_job_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-pipelines/_gitlab_integration_example_pipeline_job_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Integration Mapping</summary>
 ```yaml showLineNumbers
 resources:
   - kind: pipeline
@@ -37,4 +39,5 @@ resources:
             link: .web_url
           relations:
             pipeline: .pipeline.id | tostring
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-projects/_gitlab_integration_example_project_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-projects/_gitlab_integration_example_project_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Project blueprint</summary>
 ```json showLineNumbers
 {
   "identifier": "service",
@@ -42,4 +44,5 @@
   "calculationProperties": {},
   "relations": {}
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-projects/_gitlab_integration_example_project_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-projects/_gitlab_integration_example_project_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Integration Mapping</summary>
 ```yaml showLineNumbers
 resources:
   - kind: project
@@ -18,4 +20,5 @@ resources:
             namespace: .namespace.name
             fullPath: .namespace.full_path
             defaultBranch: .default_branch
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-releases/_gitlab_integration_example_release_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-releases/_gitlab_integration_example_release_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Release blueprint</summary>
 ```json showLineNumbers
 {
     "identifier": "gitlabRelease",
@@ -59,4 +61,5 @@
       }
     }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-releases/_gitlab_integration_example_release_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-releases/_gitlab_integration_example_release_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Integration Mapping</summary>
 ```yaml showLineNumbers
 resources:
   - kind: release
@@ -22,3 +24,4 @@ resources:
             service: .__project.path_with_namespace | gsub(" "; "")
             gitlabMember: .author.username
 ```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-tags/_gitlab_integration_example_tag_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-tags/_gitlab_integration_example_tag_blueprint.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Tag blueprint</summary>
 ```json showLineNumbers
 {
     "identifier": "gitlabTag",
@@ -43,4 +45,5 @@
       }
     }
 }
-```
+```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-tags/_gitlab_integration_example_tag_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/example-tags/_gitlab_integration_example_tag_config.mdx
@@ -1,3 +1,5 @@
+<details>
+<summary>Integration Mapping</summary>
 ```yaml showLineNumbers
 resources:
   - kind: tag
@@ -19,3 +21,4 @@ resources:
           relations:
             service: .__project.path_with_namespace | gsub(" "; "")
 ```
+</details>
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/examples.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/gitlab-v2/examples.md

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<details>`
	`2`	`+<summary>Package blueprint</summary>`
`1`	`3`	```json showLineNumbers
`2`	`4`	`{`
`3`	`5`	`"identifier": "package",`
`@@ -26,4 +28,5 @@`
`26`	`28`	`"aggregationProperties": {},`
`27`	`29`	`"relations": {}`
`28`	`30`	`}`
`29`		-```
	`31`	+```
	`32`	`+</details>`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<details>`
	`2`	`+<summary>Folder blueprint</summary>`
`1`	`3`	```json showLineNumbers
`2`	`4`	`{`
`3`	`5`	`"identifier": "gitlabFolder",`
`@@ -32,4 +34,5 @@`
`32`	`34`	`}`
`33`	`35`	`}`
`34`	`36`	`}`
`35`		-```
	`37`	+```
	`38`	`+</details>`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<details>`
	`2`	`+<summary>Group blueprint</summary>`
`1`	`3`	```json
`2`	`4`	`{`
`3`	`5`	`"identifier": "gitlabGroup",`
`@@ -39,4 +41,5 @@`
`39`	`41`	`"aggregationProperties": {},`
`40`	`42`	`"relations": {}`
`41`	`43`	`}`
`42`		-```
	`44`	+```
	`45`	`+</details>`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<details>`
	`2`	`+<summary>Group with members blueprint</summary>`
`1`	`3`	```json showLineNumbers
`2`	`4`	`{`
`3`	`5`	`"identifier": "gitlabGroup",`
`@@ -46,4 +48,5 @@`
`46`	`48`	`}`
`47`	`49`	`}`
`48`	`50`	`}`
`49`		-```
	`51`	+```
	`52`	`+</details>`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+<details>`
	`2`	`+<summary>Issue blueprint</summary>`
`1`	`3`	```json
`2`	`4`	`{`
`3`	`5`	`"identifier": "gitlabIssue",`
`@@ -57,4 +59,5 @@`
`57`	`59`	`}`
`58`	`60`	`}`
`59`	`61`	`}`
`60`		-```
	`62`	+```
	`63`	`+</details>`