Idea: Add a "General" section for each of the chapters that has both top-level contents and sections.

[crlf0710]

Currently some chapters having sub-sections are totally blank in the top-level, while some chapters has contents within the chapter-link. Personally i think this is both inconsistent and ugly. I'd suggest we move to a model closer to ISO standards and many other specifications - Move the top-level contents to a first subsection consistently called "General". (Not sure whether this is well-supported by mdbook or not).

[crlf0710]

Also cc #205

[ehuss]

Yea, the blank pages need to be filled out. Can you say specifically which ones you are looking at? I think the vast majority have content that introduces the concepts of the chapter. The empty ones that I see are:

• Lexical Structure: The whole chapter needs to be rewritten (Clean up and consolidate the lexical specification. #567).
• Type System: An introduction to Rust's type system would go here.
• Memory Model: Not sure how this should evolve. The content of all its subsections is rather weak, and could all fit on one page. However, there could be room for expansion?
• Appendices: I guess this could contain a one or two sentence description of what appendices are (contrast with why the content doesn't exist elsewhere).