Skip to content

Releases: dsccommunity/DscResource.DocGenerator

v0.9.0-preview0013

08 Jul 13:26
dd65819
Compare
Choose a tag to compare
v0.9.0-preview0013 Pre-release
Pre-release

[v0.9.0-preview0013]

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).
    • 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.
    • git commands no longer use --quiet to populate returned object.
    • No longer write a new line to the end of string for the returned properties
      StandardOutput and StandardError.

Fixed

  • Publish_GitHub_Wiki_Content
    • Output message if $GitHubToken not specified which skips this task.
      Fixes Issue 75
    • Change working folder for the call to git with the argument remote.
    • Added optional debug configuration option in build.yml.
  • Invoke-Git
    • Set $TimeOut to Milliseconds
      Fixes Issue 84
    • Calls git so it works on both Windows and Linux.
    • Output properties in return value if called with the Debug optional
      common parameter.
  • Publish-WikiContent
    • Remove a unnecessary Set-Location so it is possible to remove the
      temporary folder.
    • Fixed code style in tests.
    • Moved verbose statement so it is only outputted in the right context.
    • Fixed bug that prevented the repo to be cloned.

v0.9.0-preview0012

08 Jul 12:23
df9cf25
Compare
Choose a tag to compare
v0.9.0-preview0012 Pre-release
Pre-release

[v0.9.0-preview0012]

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).
    • 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.
    • git commands no longer use --quiet to populate returned object.

Fixed

  • Publish_GitHub_Wiki_Content
    • Output message if $GitHubToken not specified which skips this task.
      Fixes Issue 75
    • Change working folder for the call to git with the argument remote.
    • Added optional debug configuration option in build.yml.
  • Invoke-Git
    • Set $TimeOut to Milliseconds
      Fixes Issue 84
    • Calls git so it works on both Windows and Linux.
    • Output properties in return value if called with the Debug optional
      common parameter.
  • Publish-WikiContent
    • Remove a unnecessary Set-Location so it is possible to remove the
      temporary folder.
    • Fixed code style in tests.
    • Moved verbose statement so it is only outputted in the right context.
    • Fixed bug that prevented the repo to be cloned.

v0.9.0-preview0011

08 Jul 11:40
d23d17d
Compare
Choose a tag to compare
v0.9.0-preview0011 Pre-release
Pre-release

[v0.9.0-preview0011]

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).
    • 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.
    • git commands no longer use --quiet to populate returned object.

Fixed

  • Publish_GitHub_Wiki_Content
    • Output message if $GitHubToken not specified which skips this task.
      Fixes Issue 75
    • Change working folder for the call to git with the argument remote.
    • Added optional debug configuration option in build.yml.
  • Invoke-Git
    • Set $TimeOut to Milliseconds
      Fixes Issue 84
    • Calls git so it works on both Windows and Linux.
    • Output properties in return value if called with the Debug optional
      common parameter.
  • Publish-WikiContent
    • Remove a unnecessary Set-Location so it is possible to remove the
      temporary folder.
    • Fix code style in tests.
    • Moved verbose statement so it is only outputted in the right context.

v0.9.0-preview0010

07 Jul 07:27
ae1350e
Compare
Choose a tag to compare
v0.9.0-preview0010 Pre-release
Pre-release

[v0.9.0-preview0010]

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).
    • 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.
    • git commands no longer use --quiet to populate returned object.

Fixed

  • Publish_GitHub_Wiki_Content
    • Output message if $GitHubToken not specified which skips this task.
      Fixes Issue 75
    • Change working folder for the call to git with the argument remote.
  • Invoke-Git
    • Set $TimeOut to Milliseconds
      Fixes Issue 84
    • Calls git so it works on both Windows and Linux.
  • Publish-WikiContent
    • Remove a unnecessary Set-Location so it is possible to remove the
      temporary folder.
    • Fix code style in tests.
    • Moved verbose statement so it is only outputted in the right context.

v0.9.0-preview0009

06 Jul 21:50
d79b424
Compare
Choose a tag to compare
v0.9.0-preview0009 Pre-release
Pre-release

[v0.9.0-preview0009]

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).
    • 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.
    • git commands no longer use --quiet to populate returned object.

Fixed

  • Publish_GitHub_Wiki_Content
    • Output message if $GitHubToken not specified which skips this task.
      Fixes Issue 75
    • Change working folder for the call to git with the argument remote.
  • Invoke-Git
    • Set $TimeOut to Milliseconds
      Fixes Issue 84
    • Calls git so it works on both Windows and Linux.
  • Publish-WikiContent
    • Remove a unnecessary Set-Location so it is possible to remove the
      temporary folder.

v0.9.0-preview0008

06 Jul 20:01
e97551a
Compare
Choose a tag to compare
v0.9.0-preview0008 Pre-release
Pre-release

[v0.9.0-preview0008]

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).
    • 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.
    • git commands no longer use --quiet to populate returned object.

Fixed

  • Publish_GitHub_Wiki_Content
    • Output message if $GitHubToken not specified which skips this task.
      Fixes Issue 75
    • Change working folder for the call to git with the argument remote.
  • Invoke-Git
    • Set $TimeOut to Milliseconds
      Fixes Issue 84

v0.9.0-preview0007

06 Jul 18:51
1420a68
Compare
Choose a tag to compare
v0.9.0-preview0007 Pre-release
Pre-release

[v0.9.0-preview0007]

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).
    • 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.
    • git commands no longer use --quiet to populate returned object.

Fixed

  • Publish_GitHub_Wiki_Content
    • Output message if $GitHubToken not specified which skips this task.
      Fixes Issue 75
  • Invoke-Git
    • Set $TimeOut to Milliseconds
      Fixes Issue 84

v0.9.0-preview0006

26 Jun 13:45
c75f492
Compare
Choose a tag to compare
v0.9.0-preview0006 Pre-release
Pre-release

[v0.9.0-preview0006]

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).
    • 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

v0.9.0-preview0005

25 Jun 04:50
27e84f3
Compare
Choose a tag to compare
v0.9.0-preview0005 Pre-release
Pre-release

[v0.9.0-preview0005]

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).
    • 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.
  • Converted Invoke-Git cmdlet to use System.Diagnostics.Process for improved error handling.
  • 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.

Fixed

  • Publish_GitHub_Wiki_Content
    • Output message if $GitHubToken not specified which skips this task.
      Fixes Issue 75

v0.9.0-preview0004

20 Jun 13:14
0be498b
Compare
Choose a tag to compare
v0.9.0-preview0004 Pre-release
Pre-release

[v0.9.0-preview0004]

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.

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).
    • 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.
  • Converted Invoke-Git cmdlet to use System.Diagnostics.Process for improved error handling.
  • 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.

Fixed

  • Publish_GitHub_Wiki_Content
    • Output message if $GitHubToken not specified which skips this task.
      Fixes Issue 75