I got pointed to the Decision making page as a source of potential inspiration for developing some decision-making paradigms in another group I'm in. After looking through a bunch of it, I definitely see a lot of useful ideas in here, and I'm excited to adapt at least a few of them to that other context!
I'd like to share here, though, a frustration I had at the beginning of my reading, in hopes that it can help the documentation be improved for future readers.
So, specifically, on the page linked above, when i got to the "Two kinds of decisions" section, on the second bullet point, I'm faced with the term "FCP decisions", but FCP isn't defined anywhere above, or immediately following, its use. And indeed, even when following that link, one eventually finds a mention (though only after the "Definitions" section, which could be a good place for something) of a "final-comment-period", which is presumably what FCP stands for. Even there, though, it's sort of mentioned in an (IMHO) offhand way, without really laying out a description of what a "final comment period" actually is (though... it's sufficiently self-explanatory that I at least have some feel for it), let alone what an "FCP decision" is.
I think it would be great if something could be added, either at the first mention (linked below), and/or in the "Definitions" section (ditto) of the FCP decisions page. Here's the former:
|
* **[FCP decisions](./fcp-decisions.md)** represent a significant commitment from the team. They are used for [stabilization](./how_to/stabilize.md), RFC approval, and other cases where we are making a promise to our users or taking a position we don't want to reverse lightly. FCP decisions require broader team sign-off and follow a formal process for resolving concerns. |
And the latter:
Not being familiar, beyond reading some of this documentation, with the group, I don't really feel qualified to offer a suggestion for the specific wording, so... just filing this issue, in hopes that it can be enough to go on for someone more familiar, to then create something that will be useful for future readers.
Thanks!
- David (a sometimes user of Rust (relatively new to it), but here for relatively unrelated reasons.)
I got pointed to the Decision making page as a source of potential inspiration for developing some decision-making paradigms in another group I'm in. After looking through a bunch of it, I definitely see a lot of useful ideas in here, and I'm excited to adapt at least a few of them to that other context!
I'd like to share here, though, a frustration I had at the beginning of my reading, in hopes that it can help the documentation be improved for future readers.
So, specifically, on the page linked above, when i got to the "Two kinds of decisions" section, on the second bullet point, I'm faced with the term "FCP decisions", but FCP isn't defined anywhere above, or immediately following, its use. And indeed, even when following that link, one eventually finds a mention (though only after the "Definitions" section, which could be a good place for something) of a "final-comment-period", which is presumably what FCP stands for. Even there, though, it's sort of mentioned in an (IMHO) offhand way, without really laying out a description of what a "final comment period" actually is (though... it's sufficiently self-explanatory that I at least have some feel for it), let alone what an "FCP decision" is.
I think it would be great if something could be added, either at the first mention (linked below), and/or in the "Definitions" section (ditto) of the FCP decisions page. Here's the former:
lang-team/src/decision-making.md
Line 29 in 095b81f
And the latter:
lang-team/src/fcp-decisions.md
Line 7 in 095b81f
Not being familiar, beyond reading some of this documentation, with the group, I don't really feel qualified to offer a suggestion for the specific wording, so... just filing this issue, in hopes that it can be enough to go on for someone more familiar, to then create something that will be useful for future readers.
Thanks!