docs: tell new players to choose Release candidate until v3.0.0 #1216
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
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set
Reference
MagicBeanDev/Longshot!1216
Loading…
Reference in a new issue
No description provided.
Delete branch "TrashPanda/Longshot:docs/rc-until-stable"
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: local website build, Linux, Chromium · Needs: none
Why
A new player following the README presses Build the game and chooses Stable. There is no stable release (the game is still v3.0.0-rc, the launcher a release candidate), so the launcher shows "Not found" and Continue stays unavailable. The same "choose this to play" line is in the updates guide, and the install page's Stable note says "For playing."
Prior work: none for this wording (
Stable channel,choose the Stable). #1054 already made the README and the requirements page agree that AVX2 is not required. #638 is the website's release tabs, not these sentences.What changed
The install steps now say to choose Release candidate until v3.0.0 is out, and they say what Stable does today.
README.md, On Windows and Release channels). Linux says to follow the Windows steps.docs/updates-and-saves.md, and one sentence on the channel step indocs/getting-started.md(the site's install page).website/src/repo-docs/format-install.ts(Stable: "No release yet.";Release candidate: "Choose this until v3.0.0 is released.").website/tests/repo-docs.test.tsexpects the new note.The 60 GB disk figure in the README and the requirements page already match. The launcher's settings step still stops Build below 45 GB; that change is MagicBeanDev/LongshotLauncher#150, not this PR. AVX2 was left as #1054 wrote it.
Measurements
Verdict: documentation only; nothing to measure.
Flags and settings
None.
Testing
Tested:
node --test website/tests/repo-docs.test.ts(6 pass, including the channel-note assertion). Searched the tree for the old "Choose this to play" and "choose the Stable channel" lines; none remain. Local website build of/install/, Stable selected, same scroll in each shot. The version line says information is unavailable because the preview has no live release feed; the channel note and the build step do not depend on it.python -I -B tests/run_all.pyon this branch (50fbdd1c): 597 passed, 16 failed, 80 skipped, in 96 s. The same 16 fail on mainac778751. None of them read the install wording:tests/test_bug_report_defaults.pytests/test_crt_options.pytests/test_dlss_feature_size.pytests/test_failed_compile_keeps_objects.pytests/test_guest_imported.pytests/test_lift_lookups.pytests/test_linux_preflight.pytests/test_linux_update.pytests/test_make_game_cache.pytests/test_missing_nup.pytests/test_mods_size_table.pytests/test_pending_guest_import.pytests/test_run_all_changed.pytests/test_vk_occlusion_queries.pytests/test_walk.pytests/test_walk_key.pyNot tested: a run of the game. This change is the install wording.
Must be tested: None.
Risks
What could break: a player who bookmarked a Stable download still finds an empty channel. The text now says so.
Turning it off: revert the commit.
Compatibility: Nothing changes in the game, saves, settings or dependencies. The site publishes the new notes after merge.
Issues
No issue. Searched open, closed and merged pull requests for
Stable channelandchoose the Stable.Checklist
Everyone
type(scope): description) of the status line's type.main.python -I -B tests/run_all.pypasses (any failure that also fails onmainis named).third_party/untouched (a new folder with aPROVENANCE.mdinstead).When it applies
Assisted-by:/Co-Authored-By:trailers. Assisted-by only; no Cursor co-author line.Screenshots
Install page, Stable selected. The preview has no live release feed, so the version line says information is unavailable in every shot.
Desktop, dark
Before: main @
ac778751After: this PR @
50fbdd1cDesktop, light
Before: main @
ac778751After: this PR @
50fbdd1cPhone, 390 px, dark
Before: main @
ac778751After: this PR @
50fbdd1cInstall page screenshots are in the description: before main
ac778751and after50fbdd1c, desktop dark, desktop light, and 390 px dark. Stable is selected in each. Still WIP until the game-free suite has run.WIP: docs: tell new players to choose Release candidate until v3.0.0to docs: tell new players to choose Release candidate until v3.0.0Game-free suite: 597 passed, 16 failed, 80 skipped in 96 s. The same 16 fail on main
ac778751. Marked ready.View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.