Skip to content

docs: correct the claim that a deploy cannot overwrite appsettings.local.json - #47

Merged
vibesoftwarecoder merged 1 commit into
masterfrom
docs/correct-local-config-claim
Sep 10, 2026
Merged

docs: correct the claim that a deploy cannot overwrite appsettings.local.json#47
vibesoftwarecoder merged 1 commit into
masterfrom
docs/correct-local-config-claim

Conversation

@vibesoftwarecoder

Copy link
Copy Markdown
Owner

CLAUDE.md stated in two places that appsettings.local.json survives a deploy. That was true of dotnet publish and false of install-service.ps1 -FromZip, which is the path people actually upgrade with — it wiped the entire install directory before copying, deleting the local file along with everything else.

Fixed in 98b5cfa (#45 / #46), but the guidance needed correcting too. Correct-sounding advice that does not hold on the real path is worse than none, because it stops people checking.

Both places now say what is actually true, name the commit that made it true, and note that the fix is not retroactive — a host on 0.6.3 or earlier still has the destructive installer.

Docs only; no code change.

🤖 Generated with Claude Code

https://claude.ai/code/session_01SQvL62WkT8xDWXqyjFCGDw

…cal.json

It was true of `dotnet publish` and false of `install-service.ps1 -FromZip`,
which is the path people actually upgrade with. That path wiped the entire
install directory before copying, so it deleted appsettings.local.json along
with everything else -- see #45 and 98b5cfa.

Correct-sounding guidance that does not hold on the real path is worse than
none, because it stops people checking. Both places CLAUDE.md made the claim
now say what is actually true, and note that the fix is not retroactive: a host
on 0.6.3 or earlier still has the destructive installer.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SQvL62WkT8xDWXqyjFCGDw
@vibesoftwarecoder
vibesoftwarecoder merged commit 459f88d into master Sep 10, 2026
3 checks passed
@vibesoftwarecoder
vibesoftwarecoder deleted the docs/correct-local-config-claim branch September 10, 2026 14:09
@vibesoftwarecoder vibesoftwarecoder mentioned this pull request Sep 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant