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

Create sections inside the unstable book #41289

Closed
est31 opened this issue Apr 13, 2017 · 4 comments
Closed

Create sections inside the unstable book #41289

est31 opened this issue Apr 13, 2017 · 4 comments

Comments

@est31
Copy link
Member

est31 commented Apr 13, 2017

I think for greater categorisation, the unstable book should be divided into sections.

A proposal:

  • Compiler internal lang features ("not intended for general use")
  • Permanently unstable features that are not compiler internal (like the llvm intrinsics)
  • Novel lang features (with intent to stabilize them some day)
  • Library features
  • ??

Some sections should have a higher standard of documentation, like the novel lang features, others like the library features already have documentation in rustdoc (see #41288), so their documentation should be limited to a link to the tracking issue (and maybe their rustdoc), and the "not intended for general use" features can get a lower priority to be documented as well.

@frewsxcv
Copy link
Member

Folding this into #41142

@frewsxcv
Copy link
Member

Or if you feel that issue is different than what you're proposing, feel free to reopen.

@frewsxcv
Copy link
Member

I guess it's sufficiently different.

@frewsxcv frewsxcv reopened this Apr 14, 2017
@est31
Copy link
Member Author

est31 commented May 23, 2017

Oh so you made PR #41295 ... only discovered it now. It has rougher categories than what was suggested by me, but I think its a good compromise. Thanks! Closing.

@est31 est31 closed this as completed May 23, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants