Re: [libvirt] [PATCH] docs: Provide documentation for SEV launch security (DO NOT PUSH)
On Fri, Jun 28, 2019 at 04:18:23PM +0200, Andrea Bolognani wrote:
On Thu, 2019-06-27 at 17:27 +0200, Erik Skultety wrote:
> ---
>
> I sent this as a patch to get a review on the contents itself, but I believe it
> should live as an article on our wiki page afterwards.
I'll also point out that I see no reason why this should be a wiki
page rather than part of the website / installed documentation.
But then again I'm not a fan of having two separate places where
documentation can potentially live, especially when there are (to
the best of my knowledge) no clear guidelines about which kind of
content belongs to each...
Exactly, for example, NSS is treated as installed documentation, but NPIV is on
the wiki. Maybe this is a good time to decide and formulate the decision into
the guideline so we can start following it and bring some order into the chaos.
Nevertheless, I believe that (also after the recent JS changes) we should
think about how our docs can be improved, potentially separated to an
acceptable degree, IOW only host stuff related to generating docs from sources
and move the rest to something like readthedocs.io, since the navigation bars
has some issues and often I find myself using google to find a specific
resource rather than look at the nav bar, I didn't have that problem with
pykickstart and ansible, but then again, that is personal preference and
perception.
Thanks,
Erik