Update docs publish (#91)

Author: BernieWhite

.github/workflows/publish.yaml

@@ -16,17 +16,25 @@ jobs:
       - name: 📂 setup
         uses: actions/checkout@v2
 
-      - name: Use PSDocs
-        shell: pwsh
-        run: |-
-          Install-Module PSDocs -MinimumVersion '0.9.0-B2102002' -AllowPrerelease -Force;
-          Install-Module PSDocs.Azure -MinimumVersion '0.3.0' -AllowPrerelease -Force;
-          Import-Module PSDocs.Azure;
-          Get-AzDocTemplateFile -Path templates/ | ForEach-Object {
-              # Generate a standard name of the markdown file. i.e. <name>_<version>.md
-              $template = Get-Item -Path $_.TemplateFile;
-              Invoke-PSDocument -Path .ps-docs/ -Module PSDocs.Azure -OutputPath docs/templates/ -InputObject $template.FullName -Convention 'AddMeta';
-          }
+      - name: Generate docs
+        uses: microsoft/ps-docs@main
+        with:
+          conventions: AddMeta
+          modules: PSDocs,PSDocs.Azure
+          outputPath: docs/templates/
+          prerelease: true
+
+      # - name: Use PSDocs
+      #   shell: pwsh
+      #   run: |-
+      #     Install-Module PSDocs -MinimumVersion '0.9.0-B2102002' -AllowPrerelease -Force;
+      #     Install-Module PSDocs.Azure -MinimumVersion '0.3.0' -AllowPrerelease -Force;
+      #     Import-Module PSDocs.Azure;
+      #     Get-AzDocTemplateFile -Path templates/ | ForEach-Object {
+      #         # Generate a standard name of the markdown file. i.e. <name>_<version>.md
+      #         $template = Get-Item -Path $_.TemplateFile;
+      #         Invoke-PSDocument -Path .ps-docs/ -Module PSDocs.Azure -OutputPath docs/templates/ -InputObject $template.FullName -Convention 'AddMeta';
+      #     }
 
       - name: Setup Python
         uses: actions/setup-python@v2.2.2

.ps-docs/Conventions.Doc.ps1

@@ -3,7 +3,8 @@
 
 # Synopsis: Add metadata for Jekyll
 Export-PSDocumentConvention 'AddMeta' {
-    $template = Get-Item -Path $PSDocs.TargetObject;
+    # $template = Get-Item -Path $PSDocs.TargetObject;
+    $template = Get-Item -Path $PSDocs.Source.FullName;
 
     # Get parent directory paths where <templateName>/v<version>/template.json
     $version = $template.Directory.Name;
@@ -18,8 +19,7 @@ Export-PSDocumentConvention 'AddMeta' {
     }
     $PSDocs.Document.InstanceName = $docName;
 
-
-    $metadata = GetTemplateMetadata -Path $PSDocs.TargetObject;
+    $metadata = Get-Content -Path $template.FullName -Raw | ConvertFrom-Json | GetTemplateMetadata -Path $template.FullName;
     $Document.Metadata['title'] = $version;
     $Document.Metadata['parent'] = $metadata.name;
     $Document.Metadata['grand_parent'] = 'Templates'