reference
reference copied to clipboard
Keyword - Usage Table
Just like we have the punctuation table that has links to where it's used, it'd be nice to have a table for keywords and where the keywords are used.
Would it be sufficient to have the keywords in keywords.md link to where it's used?
In relation to #211, I'm thinking whether or not there should be a single Appendix with all "weird things" just like the first edition book, or if it is sufficient to have it spread across multiple pages (keywords.md, tokens.md, etc.). I kinda like the idea of a single page, but would want to avoid too much duplication.
I think there should definitely be the keywords on their own at least to start just to get it out there (I'm worried that it may turn into another reference where it's not fully documented for a while.) but a sort of book of out-there Rust knowledge, a sort of 'liber arcanum' is absolutely something I would love to see. If I knew a bit about using mdBook, I'd start getting on documenting the large amount of obscure knowledge I know.
If there was a 'Doc Arcanum,' should there be a straight-up list of facts that can help you or would that be better suited for a sort of 'useful rust patterns' doc. Does the latter exist?
OK funny enough with a comment from ehuss on a different issue, I learned a thing that I should have known long before: keywords are documented in the std docs. There's a section under Primitive Types, Modules, and Macros called Keywords and if you click on it it gives you a massive list of keywords and each entry there (when you click on one) gives some documentation on what it is and how it's used. Here's a link to the list: https://doc.rust-lang.org/std/#keywords. Is this what you were thinking of, @Havvy?