From cc9710890fc0f8cce10ec0bed934b2059beccd73 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fran=C3=A7ois=20de=20Metz?= <francois@2metz.fr>
Date: Mon, 5 Dec 2022 22:26:40 +0100
Subject: [PATCH] Add doc on github_organization_dependabot_alert and
 github_repository_dependabot_alert

---
 .../github_organization_dependabot_alert.md   | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 docs/tables/github_organization_dependabot_alert.md

diff --git a/docs/tables/github_organization_dependabot_alert.md b/docs/tables/github_organization_dependabot_alert.md
new file mode 100644
index 00000000..24afe11d
--- /dev/null
+++ b/docs/tables/github_organization_dependabot_alert.md
@@ -0,0 +1,52 @@
+# Table: github_organization_dependabot_alert
+
+The `github_organization_organization_dependabot_alert` table can be used to query information about dependabot alerts. You must be an owner or security manager for the organization to successfully query dependabot alerts.
+
+**You must specify the organization** in the where or join clause (`where organization=`, `join github_organization_depedanbot_alert on organization=`).
+
+## Examples
+
+### List dependabot alert
+
+```sql
+select
+  organization,
+  state,
+  dependency_package_ecosystem,
+  dependency_package_name
+from
+  github_organization_dependabot_alert
+where
+  organization = 'my_org';
+```
+
+### List open dependabot alerts
+
+```sql
+select
+  organization,
+  state,
+  dependency_package_ecosystem,
+  dependency_package_name
+from
+  github_organization_dependabot_alert
+where
+  organization = 'my_org'
+  and state = 'open';
+```
+
+### List open critical dependabot alerts
+
+```sql
+select
+  organization,
+  state,
+  dependency_package_ecosystem,
+  dependency_package_name
+from
+  github_organization_dependabot_alert
+where
+  organization = 'my_org'
+  and state = 'open'
+  and security_advisory_severity='critical';
+```