feat: Update framework docs

Author: GeekMasher

ql/lib/codeql/bicep/frameworks/Microsoft/Compute.qll

@@ -4,126 +4,212 @@ private import bicep
  * A resource of type Microsoft.Compute/virtualMachines
  */
 module Compute {
+  /**
+   * Represents a generic Microsoft.Compute resource.
+   * Matches any resource of type Microsoft.Compute/*.
+   */
   class ComputeResource extends Resource {
+    /**
+     * Constructs a ComputeResource for any Microsoft.Compute resource type.
+     */
     ComputeResource() { this.getResourceType().regexpMatch("^Microsoft.Compute/.*") }
   }
 
   /**
-   * A resource of type Microsoft.Compute/virtualMachines
-   * https://learn.microsoft.com/en-us/azure/templates/microsoft.compute/virtualmachines
+   * Represents a Microsoft.Compute/virtualMachines resource.
+   * See: https://learn.microsoft.com/en-us/azure/templates/microsoft.compute/virtualmachines
    */
   class VirtualMachines extends ComputeResource {
+    /**
+     * Constructs a VirtualMachines resource.
+     */
     VirtualMachines() {
       this.getResourceType().regexpMatch("^Microsoft.Compute/virtualMachines@.*")
     }
 
+    /**
+     * Returns a string representation of the VirtualMachines resource.
+     */
     override string toString() { result = "VirtualMachines Resource" }
 
+    /**
+     * Returns the properties object for this virtual machine.
+     */
     VirtualMachinesProperties::Properties getProperties() {
       result = this.getProperty("properties")
     }
 
     /**
-     * The the hardware network interfaces of the virtual machine
+     * Returns the hardware network interfaces of the virtual machine.
      */
     Network::NetworkInterfaces getNetworkInterfaces() {
       result = this.getProperties().getNetworkProfile().getNetworkInterfaces()
     }
   }
 
   /**
-   * The properties module for Microsoft.Compute/virtualMachines
+   * The properties module for Microsoft.Compute/virtualMachines resources.
    */
   module VirtualMachinesProperties {
     /**
-     * The properties object for the Microsoft.Compute/virtualMachines type
+     * The properties object for the Microsoft.Compute/virtualMachines type.
      */
     class Properties extends Object {
       private VirtualMachines virtualMachines;
 
+      /**
+       * Constructs a Properties object for the given virtual machine.
+       */
       Properties() { this = virtualMachines.getProperty("properties") }
 
+      /**
+       * Returns the parent VirtualMachines resource.
+       */
       VirtualMachines getVirtualMachine() { result = virtualMachines }
 
+      /**
+       * Returns the hardware profile object for the virtual machine.
+       */
       HardwareProfile getHardwareProfile() { result = this.getProperty("hardwareProfile") }
 
+      /**
+       * Returns the network profile object for the virtual machine.
+       */
       NetworkProfile getNetworkProfile() { result = this.getProperty("networkProfile") }
 
+      /**
+       * Returns the OS profile object for the virtual machine.
+       */
       OsProfile getOsProfile() { result = this.getProperty("osProfile") }
     }
 
     /**
-     * The hardwareProfile property object for the Microsoft.Compute/virtualMachines type
+     * The hardwareProfile property object for the Microsoft.Compute/virtualMachines type.
      */
     class HardwareProfile extends Object {
       private Properties properties;
 
+      /**
+       * Constructs a HardwareProfile object for the given properties.
+       */
       HardwareProfile() { this = properties.getProperty("hardwareProfile") }
 
+      /**
+       * Returns a string representation of the hardware profile.
+       */
       string toString() { result = "HardwareProfile" }
 
+      /**
+       * Returns the vmSize property of the hardware profile.
+       */
       Expr getVmSize() { result = this.getProperty("vmSize") }
     }
 
     /**
-     * A NetworkProfile for the Microsoft.Compute/virtualMachines type
+     * Represents a network profile for the Microsoft.Compute/virtualMachines type.
      */
     class NetworkProfile extends Object {
       private Properties properties;
 
+      /**
+       * Constructs a NetworkProfile object for the given properties.
+       */
       NetworkProfile() { this = properties.getProperty("networkProfile") }
 
+      /**
+       * Returns a string representation of the network profile.
+       */
       string toString() { result = "NetworkProfile" }
 
+      /**
+       * Returns the network interfaces for the virtual machine.
+       */
       Network::NetworkInterfaces getNetworkInterfaces() {
         result = resolveResource(this.getNetworkInterfacesObject())
       }
 
+      /**
+       * Returns the networkInterfaces property as an object array.
+       */
       private Object getNetworkInterfacesObject() {
         result = this.getProperty("networkInterfaces").(Array).getElements()
       }
     }
 
     /**
+     * Represents the storage profile for the Microsoft.Compute/virtualMachines type.
      */
     class StorageProfile extends Object {
       private Properties properties;
 
+      /**
+       * Constructs a StorageProfile object for the given properties.
+       */
       StorageProfile() { this = properties.getProperty("storageProfile") }
 
+      /**
+       * Returns the image reference for the storage profile.
+       */
       ImageReference getImageReference() { result = this.getProperty("imageReference") }
     }
 
     /**
-     * A ImageReference for the Microsoft.Compute/virtualMachines type
-     * https://learn.microsoft.com/en-us/azure/templates/microsoft.compute/virtualmachines?pivots=deployment-language-bicep#imagereference
+     * Represents an image reference for the Microsoft.Compute/virtualMachines type.
+     * See: https://learn.microsoft.com/en-us/azure/templates/microsoft.compute/virtualmachines?pivots=deployment-language-bicep#imagereference
      */
     class ImageReference extends Object {
       private StorageProfile storageProfile;
 
+      /**
+       * Constructs an ImageReference object for the given storage profile.
+       */
       ImageReference() { this = storageProfile.getProperty("imageReference") }
 
+      /**
+       * Returns the publisher property of the image reference.
+       */
       Expr getPublisher() { result = this.getProperty("publisher") }
 
+      /**
+       * Returns the offer property of the image reference.
+       */
       Expr getOffer() { result = this.getProperty("offer") }
 
+      /**
+       * Returns the sku property of the image reference.
+       */
       Expr getSku() { result = this.getProperty("sku") }
 
+      /**
+       * Returns the version property of the image reference.
+       */
       Expr getVersion() { result = this.getProperty("version") }
     }
 
     /**
-     * The OsProfile object for the Microsoft.Compute/virtualMachines type
+     * Represents the OS profile for the Microsoft.Compute/virtualMachines type.
      */
     class OsProfile extends Object {
       private Properties properties;
 
+      /**
+       * Constructs an OsProfile object for the given properties.
+       */
       OsProfile() { this = properties.getProperty("osProfile") }
 
+      /**
+       * Returns the computerName property of the OS profile.
+       */
       Expr getComputerName() { result = this.getProperty("computerName") }
 
+      /**
+       * Returns the adminUsername property of the OS profile.
+       */
       Expr getAdminUsername() { result = this.getProperty("adminUsername") }
 
+      /**
+       * Returns the adminPassword property of the OS profile.
+       */
       Expr getAdminPassword() { result = this.getProperty("adminPassword") }
     }
   }

ql/lib/codeql/bicep/frameworks/Microsoft/Network.qll

@@ -2,110 +2,162 @@ private import bicep
 
 module Network {
   /**
-   * A resource of type Microsoft.Network
+   * Represents a generic Microsoft.Network resource.
+   * Matches any resource of type Microsoft.Network/*.
    */
   class NetworkResource extends Resource {
+    /**
+     * Constructs a NetworkResource for any Microsoft.Network resource type.
+     */
     NetworkResource() { this.getResourceType().regexpMatch("^Microsoft.Network/.*") }
   }
 
   /**
-   * A resource of type Microsoft.Network/networkInterfaces
+   * Represents a Microsoft.Network/networkInterfaces resource.
    */
   class NetworkInterfaces extends NetworkResource {
+    /**
+     * Constructs a NetworkInterfaces resource.
+     */
     NetworkInterfaces() {
       this.getResourceType().regexpMatch("^Microsoft.Network/networkInterfaces@.*")
     }
 
+    /**
+     * Returns a string representation of the NetworkInterfaces resource.
+     */
     override string toString() { result = "NetworkInterfaces Resource" }
 
+    /**
+     * Returns the properties object for this network interface.
+     */
     NetworkInterfaceProperties::Properties getProperties() {
       result = this.getProperty("properties")
     }
   }
 
   /**
-   * A module for all properties of Microsoft.Network/networkInterfaces
+   * A module for all properties of Microsoft.Network/networkInterfaces resources.
    */
   module NetworkInterfaceProperties {
     /**
-     * The properties object for the Microsoft.Network/networkInterfaces type
+     * The properties object for the Microsoft.Network/networkInterfaces type.
      */
     class Properties extends Object {
       private NetworkInterfaces networkInterfaces;
 
+      /**
+       * Constructs a Properties object for the given network interface.
+       */
       Properties() { this = networkInterfaces.getProperty("properties") }
 
+      /**
+       * Returns the ipConfigurations property as an array of IpConfiguration objects.
+       */
       IpConfiguration getIpConfigurations() {
         result = this.getProperty("ipConfigurations").(Array).getElements()
       }
     }
 
     /**
-     * An IpConfiguration for the Microsoft.Network/networkInterfaces type
-     * https://learn.microsoft.com/en-us/azure/templates/microsoft.compute/virtualmachines?pivots=deployment-language-bicep#virtualmachinenetworkinterfaceipconfigurationproperties
+     * Represents an IpConfiguration for the Microsoft.Network/networkInterfaces type.
+     * See: https://learn.microsoft.com/en-us/azure/templates/microsoft.compute/virtualmachines?pivots=deployment-language-bicep#virtualmachinenetworkinterfaceipconfigurationproperties
      */
     class IpConfiguration extends Object {
       private Properties properties;
 
+      /**
+       * Constructs an IpConfiguration object for the given properties.
+       */
       IpConfiguration() { this = properties.getProperty("ipConfigurations").(Array).getElements() }
 
+      /**
+       * Returns the name property of the IpConfiguration.
+       */
       string getName() { result = this.getProperty("name").(StringLiteral).getValue() }
     }
   }
 
   /**
-   * A resource of type Microsoft.Network/virtualNetworks
+   * Represents a Microsoft.Network/virtualNetworks resource.
    */
   class VirtualNetworks extends NetworkResource {
+    /**
+     * Constructs a VirtualNetworks resource.
+     */
     VirtualNetworks() {
       this.getResourceType().regexpMatch("^Microsoft.Network/virtualNetworks@.*")
     }
 
+    /**
+     * Returns a string representation of the VirtualNetworks resource.
+     */
     override string toString() { result = "VirtualNetworks Resource" }
 
     /**
-     * Get the properties object for the Microsoft.Network/virtualNetworks type
+     * Returns the properties object for the Microsoft.Network/virtualNetworks type.
      */
     VirtualNetworkProperties::Properties getProperties() { result = this.getProperty("properties") }
   }
 
   /**
-   * A resource of type Microsoft.Network/virtualNetworks/subnets
+   * Represents a Microsoft.Network/virtualNetworks/subnets resource.
    */
   class VirtualNetworkSubnets extends Resource {
+    /**
+     * Constructs a VirtualNetworkSubnets resource.
+     */
     VirtualNetworkSubnets() {
       this.getResourceType().regexpMatch("^Microsoft.Network/virtualNetworks/subnets@.*")
     }
   }
 
   module VirtualNetworkProperties {
     /**
-     * The properties object for the Microsoft.Network/virtualNetworks/subnets type
+     * The properties object for the Microsoft.Network/virtualNetworks/subnets type.
      */
     class Properties extends Object {
       private VirtualNetworkSubnets virtualNetworkSubnets;
 
+      /**
+       * Constructs a Properties object for the given subnet.
+       */
       Properties() { this = virtualNetworkSubnets.getProperty("properties") }
 
+      /**
+       * Returns the address space object for the subnet.
+       */
       AddressSpace getAddressSpace() { result = this.getProperty("addressSpace") }
 
+      /**
+       * Returns true if DDoS protection is enabled for the subnet.
+       */
       boolean getEnableDdosProtection() {
         result = this.getProperty("enableDdosProtection").(Boolean).getBool()
       }
 
+      /**
+       * Returns true if VM protection is enabled for the subnet.
+       */
       boolean getEnableVmProtection() {
         result = this.getProperty("enableVmProtection").(Boolean).getBool()
       }
     }
 
     /**
-     * An AddressSpace for the Microsoft.Network/virtualNetworks type
+     * Represents an AddressSpace for the Microsoft.Network/virtualNetworks type.
      */
     class AddressSpace extends Object {
       private Properties properties;
 
+      /**
+       * Constructs an AddressSpace object for the given properties.
+       */
       AddressSpace() { this = properties.getProperty("addressSpace") }
 
+      /**
+       * Returns the addressPrefixes property as a string value.
+       */
       string getAddressPrefixes() {
         result =
           this.getProperty("addressPrefixes").(Array).getElements().(StringLiteral).getValue()