|
|
|
@ -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: |
|
|
|
|
Raimund Andrée
1 week ago
GitHub