Skip to content

Latest commit

 

History

History
66 lines (45 loc) · 1.49 KB

Export-AvmReadmeNote.md

File metadata and controls

66 lines (45 loc) · 1.49 KB

Export-AvmReadmeNote

Synopsis

Extract authored Bicep README Notes into an adjacent, tracked sidecar.

Description

One-time migration only. Copies the body of the top-level ## Notes section from README.md to README.notes.md without overwriting either file. Existing sidecars are left unchanged; normal documentation generation reads only the sidecar, never README Notes.

CLI commands

  • avm docs export-notes

Syntax

Export-AvmReadmeNote [[-Path] <string>] [-SkipModuleVersionCheck] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters

-Path

Directory containing the existing README.md. Defaults to the current directory. Run once per module with authored Notes.

Property Value
Type String
Required false
Position 1
Default value $PWD.Path
Accept pipeline input false
Accept wildcard characters false

-SkipModuleVersionCheck

Skip the PowerShell Gallery check that otherwise stops the command when a newer Avm.Authoring version is available. Writes a warning once.

Property Value
Type Switch
Required false
Position named
Default value False
Accept pipeline input false
Accept wildcard characters false

Examples

EXAMPLE 1

avm docs export-notes -Path ./avm/res/storage/storage-account

Outputs

  • System.Management.Automation.PSObject