Re: [RFC PATCH] docs: add a proper feature overview in "About QEMU"

[Peter Maydell]

On Mon, 9 Jan 2023 at 17:04, Alex Bennée <alex.bennee@linaro.org> 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 <alex.bennee@linaro.org>

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