id = 2190
title = "qemu-block-drivers.rst.inc is embedded twice"
state = "opened"
created_at = "2024-02-23T13:19:52.241Z"
closed_at = "n/a"
labels = ["Documentation", "kind::Bug"]
url = "https://gitlab.com/qemu-project/qemu/-/issues/2190"
host-os = "n/a"
host-arch = "n/a"
qemu-version = "n/a"
guest-os = "n/a"
guest-arch = "n/a"
description = """`qemu-block-drivers.rst.inc` is included both in `docs/system/qemu-block-drivers.rst` and in `docs/system/images.rst`, so it is repeated both at https://www.qemu.org/docs/master/system/qemu-block-drivers.html and at https://www.qemu.org/docs/master/system/images.html .

This also makes the generation of the sphinx `objects.inv` search index nondeterministic: it will point to one page or the other depending on random chance at build time.

Perhaps instead of embedding the drivers, `images.rst` should point to https://www.qemu.org/docs/master/system/qemu-block-drivers.html for the list?"""
reproduce = "n/a"
additional = "n/a"