docs: consolidate Roadmap.md into Architecture and remove the root roadmap#234
Merged
Conversation
Fold the forward-looking roadmap into docs/ and drop the standalone root file. Reviewed each roadmap item: - Already tracked/done (NOT re-added): the Microsoft.PowerShell.PlatyPS help migration (CHANGELOG [Unreleased]); "list installed modules with MSAL" (ships as Get-ModulesWithVersionSortedIdentityClient / Get-ModulesWithDependency); PowerShell 7.4+ compatibility and dependency/supply-chain hardening (ongoing, documented in Architecture sections 3 and 8 and Deep-Dive). - Truly new (added to Architecture section 9 "Known gaps / follow-ups" as a "Planned feature enhancements" backlog): import a specific MSAL version; verify package hash/signature vs source metadata; preload additional non-identity assemblies; preload-from-installed mode; import a named assembly set; clean up older installed DLLPickle versions. Repoint the README "Project Documentation Map" entry from the removed Roadmap.md to docs/Architecture.md (also adds the previously-missing Architecture blueprint link). The CHANGELOG's historical "README and Roadmap" release note is left intact. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
github-actions
Bot
added
the
documentation
Contributor
Up to standards ✅🟢 Issues
|
Contributor
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
Contributor
There was a problem hiding this comment.
Pull request overview
Consolidates the previously root-level roadmap content into the existing documentation set by folding “planned enhancements” into docs/Architecture.md, and removes the standalone Roadmap.md file. This keeps roadmap/backlog items co-located with the architecture blueprint while preserving shipped/in-progress tracking in CHANGELOG.md.
Changes:
- Removed the root
Roadmap.mdfile. - Updated
README.mdto point “planned work” readers todocs/Architecture.md. - Added a “Planned feature enhancements (backlog)” list to
docs/Architecture.md(with pointers back toCHANGELOG.mdfor shipped/in-progress work).
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
Roadmap.md |
Removes the root-level roadmap in favor of docs-based tracking. |
README.md |
Repoints the “planned work” documentation map entry to the architecture blueprint. |
docs/Architecture.md |
Adds a consolidated backlog list of planned enhancements formerly tracked in Roadmap.md. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Consolidates the root
Roadmap.mdinto the docs and removes the standalone file, per the request to fold roadmap items into/docswhere relevant and keep only the truly new items.Per-item review
Already tracked or shipped — not re-added:
Microsoft.PowerShell.PlatyPShelp generationCHANGELOG.md[Unreleased]Get-ModulesWithVersionSortedIdentityClient(+Get-ModulesWithDependency)dependency-policy.json, Upstream-Compatibility)Truly new — added to
docs/Architecture.md§9 as a "Planned feature enhancements (backlog)" list:Other changes
README.md"Project Documentation Map": repointed theRoadmap.mdlink todocs/Architecture.md(also adds the previously-missing Architecture blueprint link).CHANGELOG.mdrelease note mentioning "README and Roadmap" is left intact.Docs-only + root-file removal — no
src//bundle change, so this does not trigger a release.