-
Notifications
You must be signed in to change notification settings - Fork 72
2025H2 Project Goal Proposal: Develop the capabilities to keep the FLS up to date #335
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
Merged
tomassedovic
merged 9 commits into
rust-lang:main
from
JoelMarcey:fls-up-to-date-capabilities
Jul 22, 2025
Merged
Changes from 3 commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
7043c8a
Integrate the FLS into Documentation Processes
JoelMarcey 1afd777
Updated based on internal `t-spec` team feedback
JoelMarcey 49301d4
Rename proposal file
JoelMarcey 9c9c801
Update src/2025h2/FLS-up-to-date-capabilities.md
JoelMarcey 03eedaf
Update src/2025h2/FLS-up-to-date-capabilities.md
JoelMarcey 4bde591
Update src/2025h2/FLS-up-to-date-capabilities.md
JoelMarcey 0eaeef2
Update FLS-up-to-date-capabilities.md
JoelMarcey c335c1d
Update FLS-up-to-date-capabilities.md
JoelMarcey 545bf8e
Update src/2025h2/FLS-up-to-date-capabilities.md
JoelMarcey File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,64 @@ | ||
# Develop the capabilities to keep the FLS up to date | ||
|
||
| Metadata | | | ||
|:-----------------|----------------------------------------------------------------------------------| | ||
| Point of contact | *@JoelMarcey* | | ||
| Teams | <!-- #t-spec, #t-lang, #t-opsem --> | | ||
| Task owners | <!-- @JoelMarcey --> | | ||
| Status | Proposed, Invited | | ||
JoelMarcey marked this conversation as resolved.
Show resolved
Hide resolved
JoelMarcey marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| Tracking issue | | | ||
| Zulip channel | #t-spec | | ||
|
||
## Summary | ||
|
||
Develop the capabilities and capacity to keep the FLS up to date with the Rust language. | ||
|
||
## Motivation | ||
|
||
The FLS was graciously transferred from Ferrous Systems to the Rust Project. In 2025H1, a [Project goal](https://rust-lang.github.io/rust-project-goals/2025h1/spec-fls-publish.html) to bring the FLS in and publish a version under the auspicious of the Rust Project was successfully [completed](https://github.com/rust-lang/rust-project-goals/issues/265#issuecomment-3019529070). Let's now take this to the next level by ensuring that we can keep the FLS up to date with the Rust language in a sustainable manner by developing the necessary capacity and capabilities for doing so. | ||
|
||
### The status quo | ||
|
||
The target audience here will be those that have a vested interest in Rust specification work and want to see movement forward in ensuring that our documents are as correct and complete as possible. | ||
|
||
Keeping up with documentation is not always the most glamorous role for any project. And folks like @ehuss and others are doing an outstanding job at trying to keep the Reference current with actual code behavior. This is a hard job just for one document like the Reference. It will be even more difficult adding another core document like the FLS. But that doesn't necessarily mean we can't keep the FLS as up to date as is needed by its users. | ||
|
||
### The next 6 months | ||
|
||
Explore options for developing the capability to keep the FLS updated with the Rust language, in a sustainable way, at the cadence needed by its users. | ||
|
||
The outcome of the next six months is variable. The entire six months could be investigative, with some prototyping. Or we could establish a concrete cadence and capacity for updating the FLS. | ||
|
||
### The "shiny future" we are working towards | ||
|
||
The shiny future we are working towards is to ensure that we have the capability in place to keep the FLS updated at the pace needed by its users. | ||
|
||
## Ownership and team asks | ||
|
||
**Owner:** @JoelMarcey, in his capacity of `t-spec` team member will lead this project goal. | ||
|
||
| Task | Owner(s) or team(s) | Notes | | ||
|------------------------------------|--------------------------------|---------------------------------| | ||
| Discussion and moral support | ![Team][] [t-spec], [t-lang] | | | ||
JoelMarcey marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| Adjust tooling, as needed | @JoelMarcey | Joel to find appropriate person | | ||
| Standard reviews | ![Team][] [t-lang],[t-opsem], [t-types], [bootstrap] | For any process changes, document updates and/or tooling integration | | ||
JoelMarcey marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| Continued updates for the FLS | Contributors from Ferrous Systems and others TBD | | | ||
| Review of updates to the FLS | `t-spec` and contributors from Ferrous Systems | | | ||
|
||
## Frequently asked questions | ||
|
||
### Why this Project goal? | ||
|
||
The goal is to ensure the FLS is updated sufficiently to meet the needs of its users. | ||
|
||
### Can this be done in six months? | ||
|
||
Don't know. But we need to start having the conversations and see where it can lead. | ||
|
||
### Getting documentation updated is hard. Who would do that work? | ||
|
||
This may be the biggest blocker to making this goal successful. Part of this goal will be finding people who are interested in doing the work to author and review these updates or to find the budget to hire people to do this. | ||
|
||
### What happens if the FLS and Reference combine as one specification document? | ||
|
||
That's actually a potential outcome of the `t-spec` work in the future. So this may not be totally theoretical. Hopefully the processes we come up with are not so document specific and they can withstand such a merger. |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.