Releases: PSModule/Document-PSModule
v1.0.4
🪲 [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
$DocsOutputFolderand$moduleDocsFolderwith$docsOutputFolderthroughout 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.Greenand$PSStyle.Foreground.Redfor 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-Moduleby setting-Verbose:$false, reducing unnecessary log noise.
v1.0.3
🩹 [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.ps1script 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.PlatyPSfor installation, ensuring compatibility.
GitHub Actions workflow enhancements:
- The
Action-Test.ymlworkflow 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.ymlworkflow disables certain linters for performance and disables credential persistence for increased security. [1] [2]
PowerShell module metadata improvements:
- Added
.DESCRIPTIONsections to all module functions for better help output, and added.NOTESwith control instructions toSet-PSModuleTestand its corresponding public function. [1] [2] [3] [4] [5]
v1.0.2
🩹 [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
dependenciesandgithub-actionslabels to Dependabot PRs for GitHub Actions updates in.github/dependabot.yml.
v1.0.1
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
- Update actions checkout to use node 24 by
@salmanmkcin actions/checkout#2226- Prepare v5.0.0 release by
@salmanmkcin actions/checkout#2238
⚠️ Minimum Compatible Runner Versionv2.327.1
Release NotesMake 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
- docs: update README.md by
@motssin actions/checkout#1971- Add internal repos for checking out multiple repositories by
@mouismailin actions/checkout#1977- Documentation update - add recommended permissions to Readme by
@benwellsin actions/checkout#2043- Adjust positioning of user email note and permissions heading by
@joshmgrossin actions/checkout#2044- Update README.md by
@nebuk89in actions/checkout#2194- Update CODEOWNERS for actions by
@TingluoHuangin actions/checkout#2224- Update package dependencies by
@salmanmkcin actions/checkout#2236- Prepare release v4.3.0 by
@salmanmkcin actions/checkout#2237New Contributors
@motssmade their first contribution in actions/checkout#1971@mouismailmade their first contribution in actions/checkout#1977@benwellsmade their first contribution in actions/checkout#2043@nebuk89made their first contribution in actions/checkout#2194@salmanmkcmade their first contribution in actions/checkout#2236Full Changelog: actions/checkout@v4...v4.3.0
v4.2.2
What's Changed
url-helper.tsnow leverages well-known environment variables by@jww3in actions/checkout#1941- Expand unit test coverage for
isGhesby@jww3in actions/checkout#1946Full Changelog: actions/checkout@v4.2.1...v4.2.2
v4.2.1
What's Changed
- Check out other refs/* by commit if provided, fall back to ref by
@orhantoyin actions/checkout#1924New Contributors
@Jcambassmade their first contribution in actions/checkout#1919Full Changelog: actions/checkout@v4.2.0...v4.2.1
... (truncated)
Changelog
Sourced from actions/checkout's changelog.
Changelog
V5.0.0
- Update actions checkout to use node 24 by
@salmanmkcin actions/checkout#2226V4.3.0
- docs: update README.md by
@motssin actions/checkout#1971- Add internal repos for checking out multiple repositories by
@mouismailin actions/checkout#1977- Documentation update - add recommended permissions to Readme by
@benwellsin actions/checkout#2043- Adjust positioning of user email note and permissions heading by
@joshmgrossin actions/checkout#2044- Update README.md by
@nebuk89in actions/checkout#2194- Update CODEOWNERS for actions by
@TingluoHuangin actions/checkout#2224- Update package dependencies by
@salmanmkcin actions/checkout#2236v4.2.2
url-helper.tsnow leverages well-known environment variables by@jww3in actions/checkout#1941- Expand unit test coverage for
isGhesby@jww3in actions/checkout#1946v4.2.1
- Check out other refs/* by commit if provided, fall back to ref by
@orhantoyin actions/checkout#1924v4.2.0
- Add Ref and Commit outputs by
@lucacomein actions/checkout#1180- Dependency updates by
@dependabot- actions/checkout#1777, actions/checkout#1872v4.1.7
- Bump the minor-npm-dependencies group across 1 directory with 4 updates by
@dependabotin actions/checkout#1739- Bump actions/checkout from 3 to 4 by
@dependabotin actions/checkout#1697- Check out other refs/* by commit by
@orhantoyin actions/checkout#1774- Pin actions/checkout's own workflows to a known, good, stable version. by
@jww3in actions/checkout#1776v4.1.6
- Check platform to set archive extension appropriately by
@cory-millerin actions/checkout#1732v4.1.5
- Update NPM dependencie...
v1.0.0
What's Changed
🌟 Breaking Changes
- 🌟 [Major]: Introducing
Document-PSModuleby @MariusStorhaug in #16
Full Changelog: v0...v1.0.0
v0.0.3
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
What's Changed
Other Changes
- 🩹 [Patch]: Cleanup code that is managed in
Build-PSModuleby @MariusStorhaug in #14
Full Changelog: v0...v0.0.2
v0.0.1
What's Changed
Other Changes
- Add initial test configurations, modules, and functions by @MariusStorhaug in #13
New Contributors
- @MariusStorhaug made their first contribution in #13
Full Changelog: https://github.com/PSModule/Document-PSModule/commits/v0.0.1