Skip to content
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

Should we document when features are stabilized? #60

Open
Havvy opened this issue May 23, 2017 · 4 comments
Open

Should we document when features are stabilized? #60

Havvy opened this issue May 23, 2017 · 4 comments
Labels
C-discussion Request for comments about the direction of the reference

Comments

@Havvy
Copy link
Contributor

Havvy commented May 23, 2017

The standard library documentation documents what version that various types, functions, and what not are stabilized. Since there's no "API docs" for features, other than this reference, should we be documenting when language features are stabilized into the reference?

@cbreeden
Copy link

cbreeden commented May 23, 2017

Even though we haven't done this in the past: think pre 1.0. I don't see why this can't be done post 1.0. I have written some thought concerning this topic here: https://internals.rust-lang.org/t/life-after-an-rfc/4126

Edit: Oh I misread this issue for updating RFCs upon stabilization... 😒

@est31
Copy link
Member

est31 commented May 23, 2017

@steveklabnik
Copy link
Member

@est31 that document says nothing about this topic, that I'm aware of.

@Havvy historically we haven't done this; I'm not totally opposed but there are some problems; for example, if features are modified, it's not clear to me how to do this on a fine-grained enough basis.

@Havvy Havvy added the C-discussion Request for comments about the direction of the reference label Sep 24, 2017
@Havvy
Copy link
Contributor Author

Havvy commented Dec 8, 2017

This is related to rust-lang/rust#44894

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C-discussion Request for comments about the direction of the reference
Projects
None yet
Development

No branches or pull requests

4 participants