Feedback/Suggestions for Technology Overview

[marcelamelara]

Reading through the Technology Overview section of the docs, I have the following recommendations to improve the clarity of the text:

Grates

• More clearly describe the differences/similarities between Cages and Grates. Right now, it's not clear if a grate is a special type of cage, or vice versa, for example.
• This may be a nitpicky comment on the Grates definition: "The microvisor implements a grate with access to call into the Linux kernel." -- as I understand it, this is referring to the "root grate". The wording seems to suggest that the microvisor is itself also a grate? Or is a better way to think about this as the microvisor spawns this "root grate"? The sentence also seems to be missing a word, so some re-phrasing would be helpful here.

3i System

• The term "table container" is a bit confusing, I think that something like "System call router" would be a bit clearer, or even the previous "switchboard" term could work too
• What's the difference between "privilege management system for blocking unnecessary calls" and "security control mechanism for syscall interception"? Are these describing the ACL and enforcement functions of 3i? If so, I suggest sticking to these well-understood terms.

Components

• I think that the contents of the 3i Implementation and 3i System sections should be (roughly) swapped. The former provides a succinct high-level description of 3i, while the latter provides a more detailed description of the 3i functionality. These revisions would probably also address my comments about the 3i system above.

General

• One important addition I suggest making is a small section on "Why Lind-Wasm", which discusses its advantages over container-based applications, for example. I'm not sure if this sections belongs close to the top or at the bottom of index.md, but articulating the main novelty/benefits of Lind-Wasm upfront will be key.
• Adding a figure showing an example of a couple of cages, grates, the microvisor and 3i would be super helpful.
• It would be really helpful to add links to externally defined concepts like WebAssembly and Asyncify. Similarly, links to various parts of the codebase would also be helpful.
• Please ensure consistent/correct formatting for the bulleted lists, since they aren't all being rendered properly on the website.