Received-SPF: pass (google.com: domain of linux-kernel+bounces-106415-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249;
Date: Mon, 18 Mar 2024 12:03:09 -0500
From: Bjorn Helgaas <helgaas@kernel.org>
To: linux-doc@vger.kernel.org
Cc: linux-kernel@vger.kernel.org
Subject: stable docs.kernel.org links?
Message-ID: <20240318170309.GA1187959@bhelgaas>
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

When providing a URL to a bit of code, it's nice if the URL remains
useful indefinitely, e.g., this should work "forever" because it
includes a git tag:

  https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/drivers/pci/pci.c?id=v6.8#n1300

Is there a similar "id=" mechanism for https://docs.kernel.org?  I
could use https://docs.kernel.org/core-api/genalloc.html, but the link
may become stale as docs get reorganized.

I could link to the .rst file directly with the git tag, e.g.,

  https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/core-api/genalloc.rst?id=v6.8

but of course that's not as nicely formatted.

Bjorn