-
Notifications
You must be signed in to change notification settings - Fork 12.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Documenting the process for when rustfmt/rls break #45098
Conversation
Thanks for the pull request, and welcome! The Rust team is excited to review your changes, and you should hear from @aturon (or someone else) soon. If any changes to this PR are deemed necessary, please add them as extra commits. This ensures that the reviewer can see what has changed since they last reviewed the code. Due to the way GitHub handles out-of-date commits, this should also make it reasonably obvious what issues have or haven't been addressed. Large or tricky changes may require several passes of review and changes. Please see the contribution instructions for more information. |
I added a section about updating submodules (specifically rustfmt). The process for updating rustfmt is quite involved because of the way everything is configured. This section covers the steps for updating rustfmt and rationale behind them. |
I'm still largely new to this codebase, so please help me by reviewing this and making sure it's correct! 😄 |
I've recently opened #45243 which is where I hope to enable these steps being much shorter where basically it looks like just configuring the rls/rustfmt to "broken", landing the change in rust-lang/rust, wait for a nightly, then go update rls/rustfmt, then come back and update rust-lang/rust. That way it should avoid a bunch of synchronization dances and also be much easier on contributors as there's no need to block on rls/rustfmt changes going upstream. |
@alexcrichton That's awesome! I'd be happy to update these instructions with the new steps. When you have a chance and that PR is ready, could you give me an idea of what the new steps should be? I'll then do the same thing I did with your old instructions and format and add them to this PR. 😄 |
@sunjay sure, it'd look like this:
|
@alexcrichton This is now up to date with the latest instructions from your comment above. I think these instructions look great and hopefully they'll be a lot of help to someone in the future! Just a reminder that this PR adds two sections: Breaking Tools Built With The Compiler and Updating submodules. Both sections are the result of my adventures with #44766 and are a product of your very detailed comments with instructions which I used to accomplish everything I did in that PR. 😄 I really hope these come in handy for future people working on these parts of the compiler! :) |
The process for updating rustfmt is quite involved because of the way everything is configured. This section covers the steps for updating rustfmt and rationale behind them.
📌 Commit 790604a has been approved by |
…ichton Documenting the process for when rustfmt/rls break **DO NOT MERGE YET** I'm documenting what to do when rustfmt or rls break because of your changes. I'm currently going through this and will keep adding more as I figure out what all the steps are. This first commit is based on @alexcrichton's [comment on my original PR](rust-lang#44766 (comment)). [Rendered](https://github.com/sunjay/rust/blob/breakingrustfmtrls/CONTRIBUTING.md#breaking-tools-built-with-the-compiler) Reviews are welcome, but as I mentioned, I will be revising this as I go.
Test RLS state according to rust-lang/rust#45098
DO NOT MERGE YET
I'm documenting what to do when rustfmt or rls break because of your changes. I'm currently going through this and will keep adding more as I figure out what all the steps are. This first commit is based on @alexcrichton's comment on my original PR.
Rendered
Reviews are welcome, but as I mentioned, I will be revising this as I go.