Make the PSF write-to-install-directory fixup how-to discoverable - #479
Open
Roy (RDMacLachlan) wants to merge 1 commit into
Open
Make the PSF write-to-install-directory fixup how-to discoverable#479Roy (RDMacLachlan) wants to merge 1 commit into
Roy (RDMacLachlan) wants to merge 1 commit into
Conversation
The bug asked for a simple, dedicated doc showing how to implement the PSF "write to install directory" fixup, because the main PSF doc is overloaded. That dedicated how-to now exists (psf-filesystem-writepermission.md), but the overloaded entry-point docs don't route readers to it. Close the discoverability gap instead of duplicating content. - package-support-framework.md (Get started): add a TIP in the File Redirection Fixup section linking to the dedicated write-permission how-to for customers who already know their app writes to its install directory. - package-support-framework-overview.md: point the "writes into the install folder" bullet directly at psf-filesystem-writepermission.md, and the working-directory bullet at psf-current-working-directory.md. - psf-filesystem-writepermission.md: add a Related articles section linking back to the PSF overview, get-started, and the other implement-PSF how-tos. - Bump ms.date on the edited files. Resolves AB#25600703 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
|
Learn Build status updates of commit 6af65bb: ✅ Validation status: passed
For more details, please refer to the build report. |
Roy (RDMacLachlan)
requested review from
Howard Kapustein (DrusTheAxe) and
John Kennedy (GrantMeStrength)
July 2, 2026 17:54
Howard Kapustein (DrusTheAxe)
approved these changes
Jul 7, 2026
Howard Kapustein (DrusTheAxe)
approved these changes
Aug 2, 2026
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
2 participants
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.
Resolves the doc gap behind Azure Boards work item AB#25600703.
Background
The bug (filed 2020) asked for a simple, dedicated doc showing how to implement the PSF write-to-install-directory fixup, because "the main PSF doc is overloaded." The bug owner later re-scoped it to "write doc on how to use the re-direction in the PSF."
That dedicated how-to now exists—
psf/psf-filesystem-writepermission.md("How to fix Package Support Framework Filesystem Write Permission errors")—a focused, end-to-end walkthrough of the FileRedirectionFixup withredirectedPaths.packageRelative, listed in the TOC under "How to implement PSF in your package" next to the scripting docs. The core ask is delivered; the remaining gap is discoverability: the overloaded entry-point docs don't route readers to it.Change
package-support-framework.md(Get started): added a[!TIP]in the File Redirection Fixup section linking to the dedicated write-permission how-to for customers who already know their app writes to its install directory.package-support-framework-overview.md: pointed the "writes into the install folder" bullet directly atpsf-filesystem-writepermission.md, and the working-directory bullet atpsf-current-working-directory.md.psf-filesystem-writepermission.md: added a Related articles section linking back to the PSF overview, get-started, and the other implement-PSF how-tos.ms.dateon the edited files.No content duplicated—this closes the navigation gap that the bug called out.