1251: fold NOTES into intro sentences and remove NOTES sections from recipe pages

Nadia-JSch · claude · Nadia-JSch · commit f0c7b098ebda · 2026-04-01T17:02:12.000+02:00
Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/docs/reports/dbb-cookbook/app-dependency-mapping/workload-and-application-communication-business-app-communications.mdx b/docs/reports/dbb-cookbook/app-dependency-mapping/workload-and-application-communication-business-app-communications.mdx
@@ -73,6 +73,3 @@ ORDER BY
 
 </details>
 
-**NOTES**
-
-Use this query if want to move a Business Application to the cloud and need to know what clients communicate with it. This query will also give you the date of the last communication.
diff --git a/docs/reports/dbb-cookbook/app-dependency-mapping/workload-and-application-communication-ip-service-communications.mdx b/docs/reports/dbb-cookbook/app-dependency-mapping/workload-and-application-communication-ip-service-communications.mdx
@@ -3,7 +3,7 @@ title: "Workload and Application Communication - IP Service Communications"
 sidebar_position: 7
 ---
 
-IP Service Communications
+Use this query to identify what networks your servers communicate with — classifying client IPs as private or public per device.
 
 <details>
   <summary>Click to expand the code block</summary>
@@ -61,6 +61,3 @@ GROUP BY pp.client_device_fk
 
 </details>
 
-**NOTES**
-
-Use this query to if you need to identify what networks your servers communicate with (Private or Public).
diff --git a/docs/reports/dbb-cookbook/compute/compute-devices.mdx b/docs/reports/dbb-cookbook/compute/compute-devices.mdx
@@ -3,7 +3,7 @@ title: "Compute Devices"
 sidebar_position: 9
 ---
 
-Detailed Inventory of Compute Devices
+Returns a detailed inventory of all compute devices, including hardware specs, OS, cloud metadata, location, storage, and cost data. Use this to audit your assets for missing or incomplete information.
 
 <details>
   <summary>Click to expand the code block</summary>
@@ -91,6 +91,3 @@ Detailed Inventory of Compute Devices
   ```
 </details>
 
-**NOTES**
-
-Gives the ability to manage your assets to see if you have any missing data.
diff --git a/docs/reports/dbb-cookbook/compute/device-count-by-device-type.mdx b/docs/reports/dbb-cookbook/compute/device-count-by-device-type.mdx
@@ -3,7 +3,7 @@ title: "Device Count by Device Type"
 sidebar_position: 10
 ---
 
-Count of Devices by device type.
+Returns a count of devices grouped by device type — useful for getting a quick summary of your device mix.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -16,5 +16,3 @@ Count of Devices by device type.
     order by "count" desc
     ```
 </details>
-
-**NOTES**
diff --git a/docs/reports/dbb-cookbook/compute/device-count-by-service-level.mdx b/docs/reports/dbb-cookbook/compute/device-count-by-service-level.mdx
@@ -3,7 +3,7 @@ title: "Device Count by Service Level"
 sidebar_position: 11
 ---
 
-Count of Devices by service level.
+Returns a count of devices grouped by service level, useful for understanding how your assets are distributed across production, non-production, and other environments.
 
 <details>
     <summary>Click to expand the code block</summary>
diff --git a/docs/reports/dbb-cookbook/compute/device-to-rack-inventory.mdx b/docs/reports/dbb-cookbook/compute/device-to-rack-inventory.mdx
@@ -3,7 +3,7 @@ title: "Device to Rack Inventory"
 sidebar_position: 12
 ---
 
-Run this query to get an inventory of Devices arranged by Rack and see if you have any missing data.
+Returns a physical device inventory organized by location hierarchy — building, room, row, rack, and U position. Use this to verify rack assignments and spot gaps in your physical inventory data.
 
 <details>
   <summary>Click to expand the code block</summary>
diff --git a/docs/reports/dbb-cookbook/compute/devices-missing-device_type-or-service_level.mdx b/docs/reports/dbb-cookbook/compute/devices-missing-device_type-or-service_level.mdx
@@ -3,7 +3,7 @@ title: "Devices Missing Device_Type or Service_Level"
 sidebar_position: 13
 ---
 
-Inventory of incomplete device discovery.
+Returns devices where `service_level` or `device_type` is missing, unknown, or set to a placeholder value. Note that `service_level` is set manually and is not directly discovered.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -25,6 +25,3 @@ Inventory of incomplete device discovery.
     ```
 </details>
 
-**NOTES**
-
-The `service_level` values are set by the customer and not directly discovered.
diff --git a/docs/reports/dbb-cookbook/compute/physical-device-inventory.mdx b/docs/reports/dbb-cookbook/compute/physical-device-inventory.mdx
@@ -3,7 +3,7 @@ title: "Physical Device Inventory"
 sidebar_position: 14
 ---
 
-**Inventory of Physical Device Information**
+Returns hardware specifications for physical devices — manufacturer, model, serial number, CPU, RAM, size, and hardware EOL and EOS dates. Use this to manage your physical assets and identify missing data.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -26,6 +26,3 @@ sidebar_position: 14
       ```
 </details>
 
-**NOTES**
-
-Gives ability to manage your assets to see if you have any missing data.
diff --git a/docs/reports/dbb-cookbook/compute/physical-devices-by-customer-department.mdx b/docs/reports/dbb-cookbook/compute/physical-devices-by-customer-department.mdx
@@ -3,7 +3,7 @@ title: "Physical Devices by Customer Department"
 sidebar_position: 15
 ---
 
-Inventory of Physical Devices grouped by Customer Department.
+Returns physical devices grouped by customer department, including location and discovery data. Note that asset number (asset tag) is set manually by your team and is not directly discovered. Use this to assist with physical inventory tracking by department or for chargeback reporting.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -27,6 +27,3 @@ Inventory of Physical Devices grouped by Customer Department.
     ```
 </details>
 
-**NOTES**
-
-Asset number (asset tag) is set by customer and not directly discovered. Use this to assist with physical inventory by customer department.
diff --git a/docs/reports/dbb-cookbook/compute/physical-devices-without-hardware-model.mdx b/docs/reports/dbb-cookbook/compute/physical-devices-without-hardware-model.mdx
@@ -3,7 +3,7 @@ title: "Physical Devices Without Hardware Model"
 sidebar_position: 16
 ---
 
-Lists physical devices missing hardware information to see if you have any missing data.
+Lists physical devices missing a hardware model.
 
 <details>
   <summary>Click to expand the code block</summary>
diff --git a/docs/reports/dbb-cookbook/compute/physical-inventory-by-manufacturer.mdx b/docs/reports/dbb-cookbook/compute/physical-inventory-by-manufacturer.mdx
@@ -3,7 +3,7 @@ title: "Physical Inventory by Manufacturer"
 sidebar_position: 17
 ---
 
-Physical Inventory Count – includes model and EOL/EOS.
+Returns a count of physical devices grouped by manufacturer and model, including hardware EOL and EOS dates.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -22,6 +22,3 @@ Physical Inventory Count – includes model and EOL/EOS.
     ```
 </details>
 
-**NOTES**
-
-Gives the ability to manage your assets to see if you have any missing data.
diff --git a/docs/reports/dbb-cookbook/compute/vm-density.mdx b/docs/reports/dbb-cookbook/compute/vm-density.mdx
@@ -3,7 +3,7 @@ title: "VM Density"
 sidebar_position: 18
 ---
 
-Density of the Virtualization Farms.
+Returns vCPU and RAM allocation metrics per hypervisor host, comparing allocated vs. in-service VMs. Use this to manage your physical-to-virtual asset ratios and identify over- or under-utilized hosts.
 
 <details>
   <summary>Click to expand code example</summary>
@@ -103,6 +103,3 @@ ORDER BY
 ```
 </details>
 
-**NOTES**
-
-Gives the ability to manage your physical-to-virtual assets.
diff --git a/docs/reports/dbb-cookbook/compute/vm-devices.mdx b/docs/reports/dbb-cookbook/compute/vm-devices.mdx
@@ -3,7 +3,7 @@ title: "VM Devices"
 sidebar_position: 19
 ---
 
-Inventory of Virtual Devices.
+Returns an inventory of virtual devices with resource allocations, OS, hypervisor, and cost center data. Use this to audit your virtual assets for missing or incomplete information.
 
 <details>
   <summary>Click to expand the code block</summary>
@@ -37,6 +37,3 @@ order by dc.device_name
 ```
 </details>
 
-**NOTES**
-
-Gives the ability to manage your assets to see if you have any missing data.
diff --git a/docs/reports/dbb-cookbook/compute/vm-inventory.mdx b/docs/reports/dbb-cookbook/compute/vm-inventory.mdx
@@ -3,7 +3,7 @@ title: "VM Inventory"
 sidebar_position: 20
 ---
 
-Detailed Virtual Machine Information along with Virtual Host.
+Returns paired host-guest relationships with detailed CPU, RAM, and OS specs for both. Use this as part of your VM resource management.
 
 <details>
   <summary>Click to expand the code block</summary>
@@ -107,6 +107,3 @@ Detailed Virtual Machine Information along with Virtual Host.
     ```
 </details>
 
-**NOTES**
-
-Use as part of your resource management.
diff --git a/docs/reports/dbb-cookbook/security/devices-accessed-by-external-ips.mdx b/docs/reports/dbb-cookbook/security/devices-accessed-by-external-ips.mdx
@@ -3,7 +3,7 @@ title: "Devices Accessed by External IPs"
 sidebar_position: 22
 ---
 
-Compute devices accessed by external IPs.
+Returns compute devices that have communication to or from external (public internet) IP addresses — use this to identify potential security exposure.
 
 <details>
   <summary>Click to expand the code block</summary>
@@ -25,6 +25,3 @@ Compute devices accessed by external IPs.
   ```
 </details>
 
-**NOTES**
-
-Looking for any possible security risks.
diff --git a/docs/reports/dbb-cookbook/security/devices-possibly-containing-pii-that-have-public-ips.mdx b/docs/reports/dbb-cookbook/security/devices-possibly-containing-pii-that-have-public-ips.mdx
@@ -3,7 +3,7 @@ title: "Devices Possibly Containing PII That Have Public IPs"
 sidebar_position: 23
 ---
 
-Devices containing PII (as set by customer ) or PII is ‘Not Set’ and have public IPs.
+Returns devices where PII is marked as `yes` or `not set` and that communicate with public IP addresses. Note that PII status is set manually and is not directly discovered.
 
 <details>
      <summary>Click to expand the code block</summary>
@@ -29,6 +29,3 @@ Devices containing PII (as set by customer ) or PII is ‘Not Set’ and have pu
      ```
 </details>
 
-**NOTES**
-
-Personally Identifiable Information (PII) is manually set by customer and not discovered.
diff --git a/docs/reports/dbb-cookbook/security/devices-using-commonly-exploited-ports.mdx b/docs/reports/dbb-cookbook/security/devices-using-commonly-exploited-ports.mdx
@@ -3,7 +3,7 @@ title: "Devices Using Commonly Exploited Ports"
 sidebar_position: 24
 ---
 
-Devices using these commonly exploited ports:   20, 21, 22, 23, 25, 53, 80, 139, 443, 445, 1433, 1434, 3306, 3389, 8080.
+Returns devices using commonly exploited ports (20, 21, 22, 23, 25, 53, 80, 139, 443, 445, 1433, 1434, 3306, 3389, 8080) — use this to identify and manage security risk across your environment.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -18,6 +18,3 @@ Devices using these commonly exploited ports:   20, 21, 22, 23, 25, 53, 80, 139,
     ```
 </details>
 
-**NOTES**
-
-Giving the ability to manage security risk.
diff --git a/docs/reports/dbb-cookbook/security/devices-with-mismatch-between-prod-and-non-prod-environments.mdx b/docs/reports/dbb-cookbook/security/devices-with-mismatch-between-prod-and-non-prod-environments.mdx
@@ -3,7 +3,7 @@ title: "Devices with Mismatch Between Prod and Non-Prod Environments"
 sidebar_position: 25
 ---
 
-Compute Devices with Listener / Client mismatch of Prod and Non-Prod Service Levels.
+Returns devices where production and non-production service levels are communicating with each other. Note that service levels are defined manually and are not directly discovered.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -21,6 +21,3 @@ Compute Devices with Listener / Client mismatch of Prod and Non-Prod Service Lev
     ```
 </details>
 
-**NOTES**
-
-Service Levels are defined by customer and not directly discovered.
diff --git a/docs/reports/dbb-cookbook/security/devices-with-no-oss.mdx b/docs/reports/dbb-cookbook/security/devices-with-no-oss.mdx
@@ -3,7 +3,7 @@ title: "Devices with No OSs"
 sidebar_position: 26
 ---
 
-Compute Devices with no OS captured.
+Returns devices with no OS captured — use this to identify opportunities to enrich your data with a full device discovery.
 
 <details>
      <summary>Click to expand the code block</summary>
@@ -25,6 +25,3 @@ Compute Devices with no OS captured.
      ```
 </details>
 
-**NOTES**
-
-Opportunities to enrich your data by doing a full discovery of devices.
diff --git a/docs/reports/dbb-cookbook/security/devices-with-os-but-no-software.mdx b/docs/reports/dbb-cookbook/security/devices-with-os-but-no-software.mdx
@@ -3,7 +3,7 @@ title: "Devices with OS but No Software"
 sidebar_position: 27
 ---
 
-Compute Devices with OS but no Software captured.
+Returns devices where an OS was detected but no software inventory was captured — use this to identify opportunities to enrich your data with a full device discovery.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -23,6 +23,3 @@ Compute Devices with OS but no Software captured.
     ```
 </details>
 
-**NOTES**
-
-Opportunities to enrich your data by doing a full discovery of devices.
diff --git a/docs/reports/dbb-cookbook/security/devices-with-prohibited-software-as-designated-by-customer.mdx b/docs/reports/dbb-cookbook/security/devices-with-prohibited-software-as-designated-by-customer.mdx
@@ -3,7 +3,7 @@ title: "Devices with Prohibited Software (as designated by customer)"
 sidebar_position: 28
 ---
 
-Compute Devices that may not conform to compliance rules.
+Returns devices running software flagged as prohibited — use this to identify compliance violations and opportunities to clean up devices that don't conform to your business rules.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -25,6 +25,3 @@ Compute Devices that may not conform to compliance rules.
     ```
 </details>
 
-**NOTES**
-
-Opportunities for cleanup to comply with the business rules.
diff --git a/docs/reports/dbb-cookbook/security/network-information-for-ips-without-attached-devices.mdx b/docs/reports/dbb-cookbook/security/network-information-for-ips-without-attached-devices.mdx
@@ -3,7 +3,7 @@ title: "Network Information for IPs Without Attached Devices"
 sidebar_position: 29
 ---
 
-Provides the IP records that have an ‘A’ or ‘AAAA’ record type that don’t have a corresponding device in the system.
+Returns DNS `A` and `AAAA` records for IP addresses that don’t have a corresponding device in Device42 — use this to identify opportunities to clean up DNS records or discover additional devices.
 
 <details>
     <summary>Click to expand the code block</summary>
@@ -23,6 +23,3 @@ Provides the IP records that have an ‘A’ or ‘AAAA’ record type that don
     ```
 </details>
 
-**NOTES**
-
-Use this to identify opportunities to clean up your DNS records or opportunities for additional device discovery.
