Apply suggestions from review

Co-authored-by: Michael Greene <[email protected]>
Co-authored-by: Steve Lee <[email protected]>

Author: 3 people

docs/concepts/configuration-documents/overview.md

@@ -24,8 +24,11 @@ DSC can process configuration documents to:
 - Export a new configuration document with every instance of a set of resources with the
   `dsc config export` command.
 
-Configuration documents are YAML or JSON files that contain a single object. The object's
-properties define how DSC processes the document. The top-level properties for a document are:
+Configuration documents contain a single object formatted as YAML, JSON, or Bicep (which compiles to JSON). The object's
+properties define how DSC processes the document. It is intentional that DSC configuration documents
+should be familiar to authors accustomed to working with
+[Azure Resource Manager deployment templates](./azure/azure-resource-manager/templates/).
+The top-level properties for a document are:
 
 - `$schema` (required) - Defines the URI for the JSON Schema the document adheres to. DSC
   uses this URI to know how to validate and interpret the document.
@@ -152,7 +155,7 @@ When you use this command, DSC also:
 - Provides metadata about the operation as a whole and for each resource instance.
 
 ```sh
-dsc config test --file /example.config.dsc.yaml
+dsc config test --file ./example.config.dsc.yaml
 ```
 
 ```yaml

docs/concepts/enhanced-authoring.md

@@ -164,7 +164,7 @@ specific workspace.
 ```json
 "json.schemas": [
     {
-        "fileMatch": ["**/*.dsc.resource.json", ],
+        "fileMatch": ["**/*.dsc.resource.json"],
         "url": "https://aka.ms/dsc/schemas/v3/bundled/resource/manifest.vscode.json"
     }
 ]