@ -9,13 +9,12 @@ source: repository evidence
## Current status
PRs #91 , #92 , and #93 are merged. The documentation matches the cmdlets at
`master` , and the module ships the help file generated from it
(`en-US\NTFSSecurity.dll-Help.xml`). Otherwise the module source differs
from the 4.2.6 release only by the `Remove-Item2 -PassThru` rename and
`CompatiblePSEditions` . Open PRs: #94 (work package 3) and #95 (work package
4, stacked on #94 ); the move to GitHub Actions is PR-ready locally on
`ai/github-actions` , stacked on #95 .
PRs #91 to #96 are merged; `master` (`4f9f7cc`) carries version 5.0.0,
which is not released yet. CI runs on GitHub Actions: build, docs checks,
and tests in Windows PowerShell 5.1 and PowerShell 7, plus the wiki, which
is generated from `Docs` (43 pages). AppVeyor no longer reports on `master` .
PR-ready locally: `ai/version-history` , the version history completed from
the PowerShell Gallery packages.
## Recent milestones
@ -36,24 +35,17 @@ from the 4.2.6 release only by the `Remove-Item2 -PassThru` rename and
upload had listed 870), six cmdlet-page links reworded for the help
text. AppVeyor passed 218 of 218 on the PR (54834295) and on `master`
(54834350).
- 2026-10-04: The maintainer dropped Read the Docs: the docs stay on GitHub
and the wiki is retired (Decision 9). Work package 3 committed locally on
`ai/docs-on-github` (`84328dc`). The strict Read the Docs build prepared
before stays unmerged on the local branch `ai/read-the-docs` .
- 2026-10-04: Work package 4 committed locally on `ai/manifest-version`
(`678ff90`), stacked on `ai/docs-on-github` : valid manifest (requires
PowerShell 5.1), 36 cmdlets, version 5.0.0 everywhere (Decision 10),
`-PassThur` alias. The AppVeyor test script, run locally in Windows
PowerShell 5.1, passed: no docs drift, 0 broken links, current help file,
228 of 228 Pester tests. `Test-ModuleManifest` passes in Windows
PowerShell 5.1 and PowerShell 7.6.1.
- 2026-10-04: The maintainer opened #94 and #95 , then chose to keep the wiki,
generated from `Docs` , and to move CI from AppVeyor to GitHub Actions in
one PR (Decision 11): committed locally on `ai/github-actions` , stacked on
#95 . `Wiki.Tests.ps1` failed 25 of 25 before the exporter existed and
passes in both editions; `Invoke-Tests.ps1` passed locally in Windows
PowerShell 5.1 (253 of 253) and PowerShell 7 (217 passed, 36 skipped);
actionlint found nothing.
- 2026-10-04: Work packages 3 (#94, `bde59a5` ), 4 (#95, `6665825` ), and the
move to GitHub Actions (#96, `4f9f7cc` ) merged with merge commits: Read
the Docs dropped (Decision 9), version 5.0.0 with a valid manifest
(Decision 10), CI and a wiki generated from `Docs` on GitHub Actions
(Decision 11). The first `master` run (37218869672) passed and published
the wiki (`62ec94a`, 43 pages).
- 2026-10-04: The maintainer kept the version history separate from
`CHANGELOG.md` and had it completed from the six PowerShell Gallery
packages and the commit history: release dates, notes for 4.2.2, detailed
notes for 4.2.4, and separate notes for 4.2.5 and 4.2.6
(`ai/version-history`).
## Stable capabilities
@ -72,33 +64,20 @@ next package starts only after the maintainer's go-ahead.
1. Housekeeping: done (#92).
2. Ship help: done (#93).
3. Docs on GitHub (was: Read the Docs), PR #94: Read the Docs and MkDocs
configuration removed, `Docs/index.md` renamed to `Docs/README.md` , the
wiki's version history and install steps moved into `Docs` (with
reconstructed notes for 4.2.5 and 4.2.6), contributor guide updated. Keep
the wiki on: the GitHub Actions PR generates it from `Docs` , which also
keeps the release-note links to `wiki/Version-History` working.
`Sup3rlativ3` may be asked to delete the Read the Docs project.
4. Manifest and version, PR #95 , stacked on #94 (merge #94 first with a
merge commit).
Maintainer decisions: `PowerShellVersion` 5.1, `DotNetFrameworkVersion`
4.5.2, `RootModule` ; version 5.0.0; `[Alias('PassThur')]` on
`Remove-Item2 -PassThru` , listed under Deprecated; `NTFSSecurity` ,
`Security2` , and `PrivilegeControl` carry the module version (Decision
10). Before the release, not part of the PR: set the date of the 5.0.0
section to the release date, tag `5.0.0` (no `v` prefix), build in
Release, and clean `C:\Program Files\WindowsPowerShell\Modules\NTFSSecurity`
before `Publish-Module` ; releases so far were Debug builds published with
the whole output folder (`.pdb`, `.xml` ,
`System.Management.Automation.dll` ), and the removed
`NTFSSecurity-Help.xml` would ship again.
4b. GitHub Actions for CI and the wiki (Decision 11), PR-ready on
`ai/github-actions` , stacked on #95 (merge #94 and #95 first with merge
commits). AppVeyor reports a failure on this PR because it removes
`appveyor.yml` ; that's expected. After the merge: delete the AppVeyor
project `raandree/ntfssecurity` and revoke AppVeyor's GitHub access,
check the first wiki publication, and consider **Restrict editing to
collaborators only** for the wiki.
3. Docs on GitHub: done (#94).
4. Manifest and version 5.0.0: done (#95). Before the release: set the date
of the 5.0.0 section to the release date (fold the `[Unreleased]` entries
into it), tag `5.0.0` (no `v` prefix), build in Release, and clean
`C:\Program Files\WindowsPowerShell\Modules\NTFSSecurity` before
`Publish-Module` ; releases so far were Debug builds published with the
whole output folder (`.pdb`, `.xml` , `System.Management.Automation.dll` ),
and the removed `NTFSSecurity-Help.xml` would ship again.
4b. CI and the wiki on GitHub Actions: done (#96). Left to the maintainer:
revoke AppVeyor's GitHub access if it is still granted, consider
**Restrict editing to collaborators only** for the wiki, and optionally
ask `Sup3rlativ3` to delete the Read the Docs project.
4c. Version history from the PowerShell Gallery: PR-ready on
`ai/version-history` .
5. Code defects, listed below: `review: on` , one PR per group, regression
test first. Pester 5 tests import `NTFSSecurity\bin\Release` , run in a
`$env:TEMP` sandbox and in the CI workflow (pattern: