bevyengine / bevyengine/bevy-website

First time setup issues on Windows following optimization recommendations

Open
#2,571 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
249
Forks
450
Avg merge
16h 20m
Merged PRs (30d)
6

Description

## Describe the issue

Enhancements for the Windows target in `Getting Started > Setup` are incorrect and lead to failed compiles.

## Proposed Solution

There are three major problems I ran into while troubleshooting this I needed to resolve before getting to a successful build.

1. `sccache` has a bug with the current latest version `0.17.0`

https://github.com/mozilla/sccache/issues/2397

2. nightly `share-generics` advice is backwards (or at least doesn't have a cutout for Windows developers), but it _is_ correct in the example file link

https://github.com/bevyengine/bevy/pull/2016

https://github.com/bevyengine/bevy/blob/b56fc29d3016e641754765244b5ba3f9cc504671/.cargo/config_fast_builds.toml#L134-L158

3. there's an issue with the nightly trait solver that I was informed on Discord should be temporary, but I still wanted to mention here as well

https://github.com/bevyengine/bevy/issues/25511

## Additional Information (optional)

I fixed these by disabling share-generics, setting next-solver to coherence, and installing sccache@0.16.0.

Contributor guide

Open the contributing guide

Research direction

Start in Getting Started > Setup and compare the Windows optimization instructions with the linked .cargo/config_fast_builds.toml example. Check the referenced sccache, share-generics, and nightly trait-solver reports before updating the guidance; done means a Windows newcomer can follow the setup to a successful compile without the listed failures.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.