docs(saves): clarify Windows Roaming save location #1269
No reviewers
Labels
No labels
area/accessibility
area/audio
area/input
area/install
area/menu
area/renderer
area/saves
area/tooling
area/upscaling
beanstalk: approved
beanstalk: failed
beanstalk: needs approval
beanstalk: running
beanstalk: tested
ci: approved
good first issue
gpu/amd
gpu/igpu
gpu/intel
gpu/nvidia
help wanted
kind
bug
kind
chore
kind
docs
kind
feature
kind
performance
kind
question
needs measurements
platform/linux
platform/macos
platform/steam-deck
platform/windows
preview
priority
critical
priority
high
priority
low
regression
risk
high
risk
low
risk
medium
status
blocked
status
confirmed
status
duplicate
status
invalid
status
needs-info
status
wontfix
ci: approved
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set
Reference
MagicBeanDev/Longshot!1269
Loading…
Reference in a new issue
No description provided.
Delete branch "bibiburl/Longshot:docs/clarify-roaming-save-location"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Type: docs · Risk: low · Tested on: source comparison only · Needs: website preview/checks during review
Why
A player found their saves in AppData\Roaming but could not connect that folder to the website's “Where Longshot keeps them” table. The existing
%APPDATA%\Longshot\save\path is correct for the installed nightly launcher; its Windows expansion was unexplained. The direct-launch row also omitted the--userexception.What changed
Only
docs/saves.md, the maintained source of/saves/transfer/:%APPDATA%.--user”.The existing table, page sections, portable/older-version guidance and screenshots remain in place.
Measurements
Verdict: Documentation wording only; no runtime or performance change to measure.
Flags and settings
None.
--useris an existing argument, not a changed default.Testing
Tested:
c9e3e542and released gamenightly-376-a413bf1c:host/hos_main.caccepts--userand otherwise retains the Windows build-local folder.nightly-100-5f30eea3: SaveEnvironment uses%APPDATA%\Longshot, with%USERPROFILE%\AppData\Roamingas the fallback. Launcher save documentation agrees; portable paths remain separate.git diff --checkpassed. Only the original documentation source changed; generated website content was not edited.Not tested: Website build/checks and rendered screenshots were not run; builds remain paused in this workspace. No game run or save operation performed.
Must be tested: Linux, any GPU, by hand during review: run the website's documented build/check workflow and inspect
/saves/transfer/#where-longshot-keeps-themat desktop and mobile widths, expecting the Roaming path to display correctly and the table to remain readable.Risks
What could break: The longer explanatory cell could wrap differently; preview remains outstanding. “Normally” accounts for redirected Windows profile folders, and the copyable
%APPDATA%path remains primary.Turning it off: Revert the documentation commit.
Compatibility: No game, launcher, save-format or storage behavior changes.
Issues
Related: #760. This clarifies current behavior; it does not implement or close that feature request.
Checklist
Everyone
When it applies
Marked ready for review at the author's request; outstanding checks above are not claimed complete.
WIP: docs(saves): clarify Windows Roaming save locationto docs(saves): clarify Windows Roaming save location