Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.
Sign upUnstable Book Updates needed #57224
Comments
Centril
added
A-stability
T-doc
C-tracking-issue
labels
Dec 31, 2018
This comment has been minimized.
This comment has been minimized.
Centril
added
the
T-lang
label
Dec 31, 2018
This comment has been minimized.
This comment has been minimized.
|
I think we need to rethink the unstable book altogether. Every time I have gone to it, it has been... unhelpful. Usually, I just end up reading the tracking issue anyway. Perhaps what we want instead is an automatically generated index of features... something like a table a like this:
Though maybe the status is better left to the tracking issue unless we can find a way to update it automatically... |
This comment has been minimized.
This comment has been minimized.
|
Yeah, that seems to be the issue in the ones I looked at. If we think of it as source code, the Unstable book depends on those tracking issues. But because there's no checking of the tracking issues, the source code becomes outdated and defective. |
This comment has been minimized.
This comment has been minimized.
|
@mark-i-m i have also felt like the unstable book is not meeting its goals. I would be open to the idea of a single page, with the feature names and tracking issues. Furthermore, the unstable book was made a book with the idea that it could be where documentation lands before the feature does, but given the new changes to the rfc process that @nikomatsakis and others have been talking about, if those changes go through, there will be a new place for them to live, de-ephasizing the "book" nature of the unstable book all together. |
This comment has been minimized.
This comment has been minimized.
|
I’m curious if you think that should be done as part of broader RFC reform or as its own measure? |
This comment has been minimized.
This comment has been minimized.
|
Specifically, I think that any successful process reforms will need to include heavy automation to scale well. |
ZerothLaw commentedDec 30, 2018
Mostly listing parts of the book that need work, need tracking updates, etc.
Taking a break, will add more later.