-
Notifications
You must be signed in to change notification settings - Fork 525
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
modules: describe both module filename styles without giving a clear preference #1703
Conversation
I think changing the expressed preference would require a consensus to change it. There was an intentional decision in 2018 to try to migrate towards the Rust 2018 style. |
I didn't realize that this was an intentional decision. There's little other indication of a goal of pushing the ecosystem towards the 2018 style. Not even the compiler itself was ever systematically adjusted. So, that would be a t-lang FCP then? |
@rustbot labels +I-lang-nominated |
@RalfJung IIRC, in 2018 when we designed the new module system, it was at that time an intentional decision to pointedly present it as "the new way" by contrast with "the old way". We didn't particularly push people to switch. I'm not suggesting that we would necessarily object to this proposal, but I do think it's fair to say that this proposal represents a change in recommendations, and it probably warrants at least a discussion. |
As some archaeology, this went in with: At the time, @ehuss said:
The tracking issue, where the FCP happened, was: On that thread, Josh said:
There's also some discussion between then-lang members suggesting that deprecation would have run into blocking objections. The RFC was: What that RFC says specifically is:
|
Personally, I like the argument that the reference isn't the place to say anything about which is "encouraged". The reference is the place to say "these both work", lints and the book and such are the place to say which one you should use. |
@rustbot labels -I-lang-nominated We reviewed this in lang triage today. We agreed that the 2018 lang consensus was indeed to encourage one way ( |
Co-authored-by: Josh Triplett <[email protected]>
Co-authored-by: Josh Triplett <[email protected]>
☔ The latest upstream changes (possibly dda31c8) made this pull request unmergeable. Please resolve the merge conflicts. |
I'm uncertain how to interpret this. Are you saying that you do or do not want to proceed with this change? Or is there some other change you are suggesting? My interpretation is that the current text encourages |
We did not have any current consensus to change the prior consensus, which was to encourage That is, the lang team's standing normative (in the sense of setting norms, but not in a way encoded in the language) position is what is currently written in the Reference. |
Thanks @RalfJung for putting this forward. We talked about this on the lang-docs call, then on the spec call. We're going to close this for a kind of stylistic reason. In the Reference, we document the "most recent" Rust in the main flow of text, and then we document older things we support. Most prominently, this is what we do for editions. Here, it's a closer call, but given the standing lang consensus about issuing a normative (in the sense of setting norms) position on this, it falls in the same bucket for us, and so in that way, the existing text is OK. |
There's currently no clear consensus on which filename style to use for modules, and many people have a style tha mixes both options. So let's make the reference just describe the facts, without saying which variant is preferred.
Also see the discussion on IRLO.