Main contents updates (#65)

Author: BernieWhite

.ps-docs/Conventions.Doc.ps1

@@ -22,6 +22,7 @@ Export-PSDocumentConvention 'AddMeta' {
     $metadata = GetTemplateMetadata -Path $PSDocs.TargetObject;
     $Document.Metadata['title'] = $version;
     $Document.Metadata['parent'] = $metadata.name;
+    $Document.Metadata['grand_parent'] = 'Templates'
     $Document.Metadata['description'] = $metadata.description;
     $Document.Metadata['layout'] = 'template';
 

_config.yml

@@ -41,7 +41,7 @@ exclude:
 - tests/
 - .devcontainer/
 - docs/concepts/
-- docs/cmdlets/
+- docs/commands/
 - docs/release.md
 
 # Build settings

index.md

@@ -5,7 +5,7 @@
 layout: home
 title: Home
 nav_order: 1
-permalink: /PSDocs.Azure/
+permalink: /
 ---
 
 # Git it done
@@ -90,7 +90,8 @@ PSDocs supports the following metadata:
 Field | Scope | Type | Description
 ----- | ----- | ---- | -----------
 `name`  | Template | `string` | Used for markdown page title.
-`description` | Template | `string` | Used as the top description for the markdown page.
+`summary` | Template | `string` | Used as a short description for the markdown page.
+`description` | Template | `string` | Used as a detailed description for the markdown page.
 `description` | Parameter | `string` | Used as the description for the parameter.
 `example`     | Parameter | `string`, `boolean`, `object`, or `array` | An example use of the parameter. The example is included in the JSON snippet. If an example is not included the default value is used instead.
 `ignore`      | Parameter | `boolean` | When `true` the parameter is not included in the JSON snippet.