Re: [PATCH 2/5] docs/interop/nbd.txt: Convert to rST

[Eric Blake]

On Fri, Aug 02, 2024 at 09:39:41AM GMT, Peter Maydell wrote:
> On Thu, 1 Aug 2024 at 19:39, Eric Blake <eblake@redhat.com> wrote:
> >
> > On Thu, Aug 01, 2024 at 06:01:28PM GMT, Peter Maydell wrote:
> > > Convert nbd.txt to rST format.
> > >
> > > -F: docs/interop/nbd.txt
> > > +F: docs/interop/nbd.rst
> >
> > Upstream NBD has a link to the nbd.txt page; I'll have to update that
> > link to the new name.  Is it worth creating a git symlink so the old
> > name remains a stable point to link to (even though it is no longer
> > purely text)?
> 
> I'm not super enthusiastic about doing that -- we haven't created
> symlinks for any of the other document conversions we've done.

Okay, a stability symlink is not necessary.  Currently, the NBD spec
points to the raw qemu.txt because nothing is rendered into our online
pages; but I plan to instead point it into the rendered version
reachable from https://www.qemu.org/docs/master/interop/index.html
once your patch lands.  I also found a typo in that page (right next
to where nbd will appear), so I'm submitting that patch as a followup
to this thread, if that's okay.

-- 
Eric Blake, Principal Software Engineer
Red Hat, Inc.
Virtualization:  qemu.org | libguestfs.org