DscResource.DocGenerator

0.9.0-preview0006

Functionality to help generate documentation for modules.

Minimum PowerShell version

5.0

This is a prerelease version of DscResource.DocGenerator.
There is a newer prerelease version of this module available.
See the version list below for details.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name DscResource.DocGenerator -RequiredVersion 0.9.0-preview0006 -AllowPrerelease

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Author(s)

DSC Community

Copyright

(c) DSC Community contributors.

Owners

Tags

DSC Modules documentation

Functions

Invoke-Git New-DscResourcePowerShellHelp New-DscResourceWikiPage Publish-WikiContent Set-WikiModuleVersion Split-ModuleVersion

Dependencies

This module has no dependencies.

Release Notes

## [0.9.0-preview0006] - 2021-06-26

### Added

- Added private functions:
 - `Get-ClassAst` - Returns the AST for a single or all classes.
 - `Get-ClassResourceAst` - Returns the AST for a single or all DSC class
   resources.
 - `Get-ClassResourceProperty` - Returns DSC class resource properties
   from the provided class or classes.
 - `Format-Text` - Format a string according to predefined options.
 - `Get-TemporaryPath` - returns the appropriate temp path for the OS.
 - `Get-ConfigurationAst` - Returns the AST for a single or all configurations.
 - `Get-CompositeSchemaObject` - Returns an object containing the parameters
   and other properties related to a composite resource. The object that is
   returned is different format to a MOF or class-based object and the property
   names are aligned to a configuration parameter block rather than MOF.
 - `Get-CompositeResourceParameterState` - Determines the parameter state of a
   composite resource parameter. This is a meta attribute that will either be
   `Required` or `Write`.
 - `Get-CompositeResourceParameterValidateSet` - Returns the array of values
   contained in the ValidateSet parameter attributes if it exists.
- Added QA test to do some quality checks on the module code and change log.

### Changed

- `New-DscResourceWikiPage`
 - If a class-based resource has a parent class that contains DSC resource
   properties they will now also be returned as part of the DSC resource
   parameters ([issue #62](https://github.com/dsccommunity/DscResource.DocGenerator/issues/62)).
 - Refactored to split into two private functions `New-DscMofResourceWikiPage` and
   `New-DscClassResourceWikiPage`.
- `Get-MofSchemaObject`
 - Refactored to reduce code duplication when adding functions for supporting
   composite resources.
- `Get-ClassResourceCommentBasedHelp`
 - Renamed this function to `Get-CommentBasedHelp` so that it made sense to
   use with composite DSC resources.
 - Enabled the function to extract the comment block if it is not at the top
   of the script file to support composite resources.
- Updated code to pass newly added quality checks.
- `Invoke-Git`
 - Converted to public function.
 - Updated to use `System.Diagnostics.Process` for improved error handling.
 - Returns object, allowing caller to process result.

### Fixed

- `Publish_GitHub_Wiki_Content`
 - Output message if `$GitHubToken` not specified which skips this task.
   Fixes [Issue 75](https://github.com/dsccommunity/DscResource.DocGenerator/issues/75)

Version History

Version Downloads Last updated
0.10.1 243 10/19/2021
0.10.1-previ... 2 10/18/2021
0.10.1-previ... 3 8/7/2021
0.10.1-previ... 2 8/6/2021
0.10.0 584 8/5/2021
0.10.0-previ... 2 8/5/2021
0.9.1 340 7/14/2021
0.9.1-previe... 2 7/13/2021
0.9.0 46 7/8/2021
0.9.0-previe... 2 7/8/2021
0.9.0-previe... 2 7/8/2021
0.9.0-previe... 2 7/8/2021
0.9.0-previe... 2 7/7/2021
0.9.0-previe... 2 7/6/2021
0.9.0-previe... 2 7/6/2021
0.9.0-previe... 2 7/6/2021
0.9.0-previe... (current version) 2 6/26/2021
0.9.0-previe... 2 6/25/2021
0.9.0-previe... 2 6/20/2021
0.9.0-previe... 2 6/19/2021
0.9.0-previe... 2 6/16/2021
0.9.0-previe... 2 6/8/2021
0.8.4-previe... 2 6/3/2021
0.8.3 1,439 4/10/2021
0.8.2 498 3/19/2021
0.8.1 137 3/11/2021
0.8.1-previe... 4 3/11/2021
0.8.0 514 2/8/2021
0.8.0-previe... 7 2/7/2021
0.7.4 60 2/2/2021
0.7.4-previe... 4 2/2/2021
0.7.3 7 2/2/2021
0.7.3-previe... 4 2/2/2021
0.7.3-previe... 4 1/18/2021
0.7.2 203 1/17/2021
0.7.2-previe... 5 1/17/2021
0.7.1 1,179 8/5/2020
0.7.1-previe... 3 8/5/2020
0.7.0 245 7/8/2020
0.7.0-previe... 3 7/8/2020
0.6.1 117 7/1/2020
0.6.1-previe... 3 7/1/2020
0.6.1-previe... 3 6/26/2020
0.6.0 100 6/22/2020
0.6.0-previe... 3 6/22/2020
0.6.0-previe... 3 6/20/2020
0.5.2-previe... 4 6/16/2020
0.5.1 1,258 5/1/2020
0.5.1-previe... 3 5/1/2020
0.5.0 609 3/28/2020
0.5.0-previe... 4 3/27/2020
0.4.1-previe... 5 2/26/2020
0.4.0 152 2/25/2020
0.4.0-previe... 5 2/25/2020
0.4.0-previe... 5 2/25/2020
0.4.0-previe... 5 2/18/2020
0.3.0 30 2/11/2020
0.3.0-previe... 5 2/11/2020
0.2.0 10 2/6/2020
0.1.1 7 2/2/2020
0.1.1-previe... 5 2/2/2020
Show less