Skip to content

Releases: PSModule/Document-PSModule

v1.0.4

06 Oct 11:43
ffe09c2

Choose a tag to compare

🪲 [Fix]: Fix so files are back to expected structure (#21)

Description

This pull request refactors the Build-PSModuleDocumentation.ps1 script to consistently use the $docsOutputFolder variable instead of $DocsOutputFolder or $moduleDocsFolder, and improves output formatting for command status messages. These changes help standardize variable usage and enhance script readability and maintainability.

Refactoring for variable consistency:

  • Replaced all instances of $DocsOutputFolder and $moduleDocsFolder with $docsOutputFolder throughout the script to ensure consistent variable usage for documentation output paths. [1] [2] [3]

Output and formatting improvements:

  • Updated status message output to use $PSStyle.Foreground.Green and $PSStyle.Foreground.Red for colored checkmarks and crosses, improving readability of command results.
  • Added a section to display all generated documentation files after creation, making it easier to verify output.

Minor improvements:

  • Disabled verbose output when importing the module with Import-Module by setting -Verbose:$false, reducing unnecessary log noise.

v1.0.3

06 Oct 01:07
71c21f4

Choose a tag to compare

🩹 [Patch]: Update to use Microsoft.PowerShell.PlatyPS for docs generation (#19)

Description

This pull request introduces several improvements to the documentation generation process, CI workflows, and PowerShell module metadata. The most significant changes include enhanced and more robust documentation generation, updates to GitHub Actions workflows for better security and linting, and improvements to module help comments for consistency.

Documentation generation improvements:

  • The Build-PSModuleDocumentation.ps1 script now generates markdown help per command, handles documentation file organization to match source structure, and fixes frontmatter titles for compatibility. This makes the documentation process more robust and the output more consistent. [1] [2]
  • The script now uses the full module name Microsoft.PowerShell.PlatyPS for installation, ensuring compatibility.

GitHub Actions workflow enhancements:

  • The Action-Test.yml workflow now requests explicit permissions for reading contents and writing statuses, uses a full-depth fetch for checkouts, logs file changes, commits documentation updates, and adds a markdown linter step. [1] [2] [3]
  • The Linter.yml workflow disables certain linters for performance and disables credential persistence for increased security. [1] [2]

PowerShell module metadata improvements:

  • Added .DESCRIPTION sections to all module functions for better help output, and added .NOTES with control instructions to Set-PSModuleTest and its corresponding public function. [1] [2] [3] [4] [5]

Link: https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.platyps/new-markdowncommandhelp?view=ps-modules

v1.0.2

05 Oct 10:21
e9f43e3

Choose a tag to compare

🩹 [Patch]: Update Dependabot configuration to include labels for GitHub Actions (#18)

Description

This pull request makes a small configuration update to Dependabot. It adds default labels to pull requests created for GitHub Actions updates.

  • Added dependencies and github-actions labels to Dependabot PRs for GitHub Actions updates in .github/dependabot.yml.

v1.0.1

27 Aug 12:19
353bcd4

Choose a tag to compare

Bump actions/checkout from 4 to 5 (#17)

Bumps actions/checkout from 4 to 5.

Release notes

Sourced from actions/checkout's releases.

v5.0.0

What's Changed

⚠️ Minimum Compatible Runner Version

v2.327.1
Release Notes

Make sure your runner is updated to this version or newer to use this release.

Full Changelog: actions/checkout@v4...v5.0.0

v4.3.0

What's Changed

New Contributors

Full Changelog: actions/checkout@v4...v4.3.0

v4.2.2

What's Changed

Full Changelog: actions/checkout@v4.2.1...v4.2.2

v4.2.1

What's Changed

New Contributors

Full Changelog: actions/checkout@v4.2.0...v4.2.1

... (truncated)

Changelog

Sourced from actions/checkout's changelog.

Changelog

V5.0.0

V4.3.0

v4.2.2

v4.2.1

v4.2.0

v4.1.7

v4.1.6

v4.1.5

  • Update NPM dependencie...
Read more

v1.0.0

18 Apr 02:06
42c533e

Choose a tag to compare

What's Changed

🌟 Breaking Changes

Full Changelog: v0...v1.0.0

v0.0.3

16 Feb 12:22
a4813bf

Choose a tag to compare

What's Changed

Other Changes

  • 🩹 [Patch]: Add linter configurations and update .gitignore for VS Code by @MariusStorhaug in #15

Full Changelog: v0...v0.0.3

v0.0.2

13 Feb 18:27
c1b2255

Choose a tag to compare

What's Changed

Other Changes

Full Changelog: v0...v0.0.2

v0.0.1

13 Feb 09:49
24c651c

Choose a tag to compare

What's Changed

Other Changes

New Contributors

Full Changelog: https://github.com/PSModule/Document-PSModule/commits/v0.0.1