Resolve remarks

Author: Gijsreyn

docs/reference/resources/DSC/PackageManagement/APT/examples/manage-packages-with-apt.md

@@ -13,7 +13,7 @@ that use the APT package manager.
 
 ## Test if package is installed
 
-The following snippet shows how you can use the resource with the [dsc resource test][01] command
+The following snippet shows how you can use the resource with the [dsc resource test][00] command
 to check whether the `nginx` package exists.
 
 ```bash
@@ -23,14 +23,14 @@ dsc resource test --resource DSC.PackageManagement/Apt --input '{"packageName":"
 When the package is not installed, DSC returns the following result.
 
 > [!NOTE]
-> Note that the version and source values can differ depending on your system's package repositories and available
-> package versions.
+> Note that the version and source values can differ depending on your system's package repositories
+> and available package versions.
 
 ```yaml
 desiredState:
   packageName: nginx
 actualState:
-  _exist: "true"
+  _exist: false
   packageName: nginx
   version: 1.24.0-2ubuntu7.3
   source: noble-updates,noble-security,now
@@ -39,43 +39,42 @@ differingProperties:
   - _exist
 ```
 
-## Ensure a package with version is installed
+## Ensure a package is installed
 
-To ensure the system is in the desired state with a particular version, use the [dsc resource set][02]
+To ensure the system is in the desired state, use the [dsc resource set][01]
 command.
 
 ```bash
-dsc resource set --resource DSC.PackageManagement/Apt --input '{"packageName":"nginx", "version":"1.24.0-2ubuntu7"}'
+dsc resource set --resource DSC.PackageManagement/Apt --input '{"packageName":"nginx"}'
 ```
 
-When the resource install the package, DSC returns the following result:
+When the resource installs the package, DSC returns the following result:
 
 ```yaml
 beforeState:
   packageName: "nginx"
-  version: "1.24.0-2ubuntu7"
   _exist: false
 afterState:
-  keyPath: HKCU\DscExamples\ManagedKey
-  version: "1.24.0-2ubuntu7"
+  packageName: nginx
+  version: "1.24.0-2ubuntu7.3"
+  source: noble-updates,noble-security,now
 changedProperties:
 - _exist
 ```
 
 You can test the instance again to confirm that the package exists:
 
 ```bash
-dsc resource test --resource DSC.PackageManagement/Apt --input '{"packageName":"nginx", "version":"1.24.0-2ubuntu7"}'
+dsc resource test --resource DSC.PackageManagement/Apt --input '{"packageName":"nginx"}'
 ```
 
 ```yaml
 desiredState:
   packageName: nginx
-  version: 1.24.0-2ubuntu7
 actualState:
   _exist: true
   packageName: nginx
-  version: 1.24.0-2ubuntu7
+  version: 1.24.0-2ubuntu7.3
   source: noble-updates,noble-security,now
 inDesiredState: true
 differingProperties: []
@@ -89,9 +88,6 @@ To uninstall a package, set the `_exist` property to `false`:
 dsc resource set --resource DSC.PackageManagement/Apt --input '{"packageName":"nginx", "_exist": false}'
 ```
 
-The `DSC.PackageManagement/Apt` resource implements the [setHandleExist][03], indicating the resource
-will be deleted.
-
 To verify the package no longer exists, use the `dsc resource get` command
 
 ```powershell
@@ -105,6 +101,5 @@ actualState:
 ```
 
 <!-- Link reference definitions -->
-[01]: ../../../../../cli/resource/test.md
-[02]: ../../../../../cli/resource/set.md
-[03]: ../../../../../../concepts/resources/capabilities.md#sethandlesexist
+[00]: ../../../../../cli/resource/test.md
+[01]: ../../../../../cli/resource/set.md

docs/reference/resources/DSC/PackageManagement/APT/index.md

@@ -61,7 +61,7 @@ The resource has the following capabilities:
 - `export` - You can use the resource to export the current state of the system.
 
 For more information about resource capabilities, see
-[DSC resource capabilities][01].
+[DSC resource capabilities][00].
 
 ## Examples
 
@@ -75,17 +75,16 @@ The following list describes the properties for the resource.
 - **Required properties:** <a id="required-properties"></a> The following properties are always
   required when defining an instance of the resource. An instance that doesn't define each of these
   properties is invalid. For more information, see the "Required resource properties" section in
-  [DSC resource properties][02]
+  [DSC resource properties][01]
 
   - [packageName](#packagename) - The name of the package to query or install.
 
 - **Key properties:** <a id="key-properties"></a> The following properties uniquely identify an
   instance. If two instances of a resource have the same values for their key properties, the
   instances are conflicting. For more information about key properties, see the "Key resource
-  properties" section in [DSC resource properties][03].
+  properties" section in [DSC resource properties][02].
 
   - [packageName](#packagename) (required) - The name of the package to query or install.
-  - [version](#version) (optional) - The version of the package to install.
 
 - **Instance properties:** <a id="instance-properties"></a> The following properties are optional.
   They define the desired state for an instance of the resource.
@@ -95,7 +94,7 @@ The following list describes the properties for the resource.
 
 - **Read-only properties:** <a id="read-only-properties"></a> The resource returns the following
   properties, but they aren't configurable. For more information about read-only properties, see
-  the "Read-only resource properties" section in [DSC resource properties][04].
+  the "Read-only resource properties" section in [DSC resource properties][03].
 
   - [source](#source) - Indicates the source of the package.
 
@@ -189,7 +188,7 @@ exit code, it also emits an error message with details about the invalid paramet
 - [For more information about APT](https://wiki.debian.org/Apt)
 
 <!-- Link definitions -->
-[01]: ../../../../../concepts/resources/capabilities.md
-[02]: ../../../../../concepts/resources/properties.md#required-resource-properties
-[03]: ../../../../../concepts/resources/properties.md#key-resource-properties
-[04]: ../../../../../concepts/resources/properties.md#read-only-resource-properties
+[00]: ../../../../../concepts/resources/capabilities.md
+[01]: ../../../../../concepts/resources/properties.md#required-resource-properties
+[02]: ../../../../../concepts/resources/properties.md#key-resource-properties
+[03]: ../../../../../concepts/resources/properties.md#read-only-resource-properties