On Mon, 9 Jan 2023 at 17:04, Alex Bennée <[email protected]> wrote: > > I decide to do this because I was looking for the best place to add a > reference to a document on semihosting and there didn't seem to be > an obvious place to do this. To do this I took the original pre-amble > to the about index and moved it to its own section, expanding the > description and giving a quick high level overview of some of the key > feature of QEMU. > > Signed-off-by: Alex Bennée <[email protected]>
To summarise from our conversation on IRC: (1) I like the current short summary and orientation that we have at the top of https://www.qemu.org/docs/master/about/index.html and would prefer not to delete it. We can add hyperlinks to cue the user that they can go look at the top level sections for system emulation etc for more detail. (2) I think most of this text would be better at the start of docs/system/index.rst and/or in a new subsection at the top of docs/system (which would be more easily findable from the top level if we added those hyperlinks). (3) I don't think we should be mentioning TCI this prominently. thanks -- PMM
