DscResource.DocGenerator

0.9.0-preview0006

DscResource.DocGenerator.psd1


@{
    # Script module or binary module file associated with this manifest.
    RootModule        = 'DscResource.DocGenerator.psm1'

    # Version number of this module.
    ModuleVersion     = '0.9.0'

    GUID              = 'fa8b017d-8e6e-414d-9ab7-c8ab9cb9e9a4'

    # Author of this module
    Author            = 'DSC Community'

    # Company or vendor of this module
    CompanyName       = 'DSC Community'

    # Copyright statement for this module
    Copyright         = '(c) DSC Community contributors.'

    # Description of the functionality provided by this module
    Description       = 'Functionality to help generate documentation for modules.'

    # Minimum version of the Windows PowerShell engine required by this module
    PowerShellVersion = '5.0'

    # RequiredModules = @('Sampler') # The Sampler Pack task does not support recursive pack yet.

    <#
        Functions to export from this module, for best performance, do not use
        wildcards and do not delete the entry, use an empty array if there are
        no functions to export.
 
        This will be automatically update by the build pipeline.
    #>
    FunctionsToExport = @('Invoke-Git','New-DscResourcePowerShellHelp','New-DscResourceWikiPage','Publish-WikiContent','Set-WikiModuleVersion','Split-ModuleVersion')

    <#
        Cmdlets to export from this module, for best performance, do not use
        wildcards and do not delete the entry, use an empty array if there are
        no cmdlets to export.
    #>
    CmdletsToExport   = @()

    # Variables to export from this module
    VariablesToExport = @()

    <#
        Aliases to export from this module, for best performance, do not use
        wildcards and do not delete the entry, use an empty array if there are
        no aliases to export.
 
        This must be set to the aliases to export since there is no way to tell
        the module builder (build pipeline) which aliases to add.
    #>
    AliasesToExport   = @(
        'Task.Generate_Conceptual_Help',
        'Task.Generate_Wiki_Content',
        'Task.Publish_GitHub_Wiki_Content'
    )

    # DSC resources to export from this module
    DscResourcesToExport = @()

    <#
        Private data to pass to the module specified in RootModule/ModuleToProcess.
        This may also contain a PSData hashtable with additional module metadata
        used by PowerShell.
    #>
    PrivateData       = @{
        PSData = @{
            # Tags applied to this module. These help with module discovery in online galleries.
            Tags         = @('DSC', 'Modules', 'documentation')

            # A URL to the license for this module.
            LicenseUri   = 'https://github.com/dsccommunity/DscResource.DocGenerator/blob/main/LICENSE'

            # A URL to the main website for this project.
            ProjectUri   = 'https://github.com/dsccommunity/DscResource.DocGenerator'

            # ReleaseNotes of this module
            ReleaseNotes = '## [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)
 
'

            # Prerelease string of this module
            Prerelease = 'preview0006'
        } # End of PSData hashtable
    } # End of PrivateData hashtable
}