You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documentation/development-docs/help-generation.md
+12-2Lines changed: 12 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,6 @@ To do so, you can follow the below steps (which are outlined in the [**Quick sta
12
12
13
13
```powershell
14
14
Install-Module -Name platyPS -Scope CurrentUser
15
-
Import-Module platyPS
16
15
```
17
16
18
17
**Note:** this module will need to be installed from the [PowerShell Gallery](http://www.powershellgallery.com/). If, for some reason, this isn't a registered repository when running the `Get-PSRepository` cmdlet, then you will need to register it by running the following command:
**Note**: if you do not see all of the changes you made to the cmdlets in your markdown files (_e.g.,_ a cmdlet you deleted is still appearing), you may need to delete any existing Azure PowerShell modules that you have on your machine (installed either through the PowerShell Gallery or by Web Platform Installer) before you import your module.
40
39
40
+
### Generating help for a new module
41
+
42
+
For new modules with no existing `help` folder containing the markdown help files, run the following command to do an initial generation:
43
+
44
+
```powershell
45
+
$PathToHelpFolder = "../../help" # Full path to help folder containing markdown files to be generated (e.g., src/Accounts/Accounts/help)
Once this folder has been generated, follow the steps provided in the below section to update the files with any changes made to the public interface of the cmdlets.
50
+
41
51
### Updating help after making cmdlet changes
42
52
43
53
Whenever the public interface for a cmdlet has changed, the corresponding markdown file for that cmdlet will need to be updated to reflect the changes. Public interface changes include the following:
@@ -70,7 +80,7 @@ If you would like to update the inputs/outputs for a markdown file, please run t
70
80
This will update all of the markdown files with public interface changes made to corresponding cmdlets, add markdown files for any new cmdlets, remove markdown files for any deleted cmdlets, and update the module page (_e.g.,_`Az.Accounts.md`) with any added or removed cmdlets.
71
81
72
82
_This seems to work better when run from within the `help` folder itself (For e.g. to generate the help files for the [`Network`](src/Network) module run the cmd from under [`Commands.Network/help`](src/Network/Network/help)). Also, you will have to import the profile module from under <Repobasepath>/artifacts/Debug/Az.Accounts/Az.Accounts.psd1_
73
-
83
+
74
84
#### Updating a single markdown file
75
85
76
86
To update a single markdown file with the changes made to the corresponding cmdlet, use the [`Update-MarkdownHelp`](https://github.com/PowerShell/platyPS/blob/master/docs/Update-MarkdownHelp.md) cmdlet:
0 commit comments