diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-deployments-environments/_github_exporter_example_deployments_and_environments_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-deployments-environments/_github_exporter_example_deployments_and_environments_port_app_config.mdx
index 9735a19abb..147adeeca8 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-deployments-environments/_github_exporter_example_deployments_and_environments_port_app_config.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-deployments-environments/_github_exporter_example_deployments_and_environments_port_app_config.mdx
@@ -1,3 +1,6 @@
+import Tabs from "@theme/Tabs"
+import TabItem from "@theme/TabItem"
+
Port port-app-config.yml (click to expand)
@@ -57,3 +60,35 @@ resources:
```
+
+
+
+
+
+You can use the `task` selector to filter deployments by task name (for example, `deploy` or `deploy:migrations`).
+
+```yaml showLineNumbers
+- kind: deployment
+ selector:
+ query: "true"
+ # highlight-next-line
+ task: "deploy"
+```
+
+
+
+
+
+You can use the `environment` selector to filter deployments by environment name (for example, `staging` or `production`).
+
+```yaml showLineNumbers
+- kind: deployment
+ selector:
+ query: "true"
+ # highlight-next-line
+ environment: "production"
+```
+
+
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-issue/_github_exporter_example_issue_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-issue/_github_exporter_example_issue_port_app_config.mdx
index 8d83290f5f..e7d6cc0706 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-issue/_github_exporter_example_issue_port_app_config.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-issue/_github_exporter_example_issue_port_app_config.mdx
@@ -1,3 +1,6 @@
+import Tabs from "@theme/Tabs"
+import TabItem from "@theme/TabItem"
+
Port port-app-config.yml (click to expand)
@@ -43,3 +46,22 @@ resources:
```
+
+
+
+
+
+You can use the `labels` selector to filter issues by labels.
+An issue is ingested only if it has **all** of the labels you set (AND logic); if it has only some of them, it is not included.
+
+```yaml showLineNumbers
+- kind: issue
+ selector:
+ query: ".pull_request == null"
+ # highlight-next-line
+ labels: ["bug", "high-priority"]
+```
+
+
+
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-repository-alerts/_github_exporter_example_repo_dependabot_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-repository-alerts/_github_exporter_example_repo_dependabot_port_app_config.mdx
index e16ef0bb8b..4a1fbf4730 100644
--- a/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-repository-alerts/_github_exporter_example_repo_dependabot_port_app_config.mdx
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/github-ocean/examples/example-repository-alerts/_github_exporter_example_repo_dependabot_port_app_config.mdx
@@ -1,3 +1,6 @@
+import Tabs from "@theme/Tabs"
+import TabItem from "@theme/TabItem"
+
Port port-app-config.yml (click to expand)
@@ -81,3 +84,55 @@ resources:
```
+
+
+
+
+
+You can use the `severity` selector to filter dependabot alerts by severity levels.
+An alert is ingested if its severity is **any one** of the severities you set (OR logic across the list). Valid values: `low`, `medium`, `high`, `critical`.
+
+```yaml showLineNumbers
+- kind: dependabot-alert
+ selector:
+ query: "true"
+ states: ["open", "fixed"]
+ # highlight-next-line
+ severity: ["high", "critical"]
+```
+
+
+
+
+
+You can use the `ecosystems` selector to filter dependabot alerts by package ecosystems.
+An alert is ingested if its ecosystem is **any one** of the ecosystems you set (OR logic across the list). Valid values: `composer`, `go`, `maven`, `npm`, `nuget`, `pip`, `pub`, `rubygems`, `rust`.
+
+```yaml showLineNumbers
+- kind: dependabot-alert
+ selector:
+ query: "true"
+ states: ["open", "fixed"]
+ # highlight-next-line
+ ecosystems: ["npm", "pip"]
+```
+
+
+
+
+
+You can use the `severity` selector to filter code scanning alerts by severity level.
+An alert is ingested only if its severity matches the value you set. Valid values: `critical`, `high`, `medium`, `low`, `warning`, `note`, `error`.
+
+```yaml showLineNumbers
+- kind: code-scanning-alerts
+ selector:
+ query: "true"
+ state: "open"
+ # highlight-next-line
+ severity: "high"
+```
+
+
+
+