]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
docs: reporting-issues: mention text is best viewed rendered
authorThorsten Leemhuis <linux@leemhuis.info>
Tue, 17 Mar 2026 12:33:04 +0000 (13:33 +0100)
committerJonathan Corbet <corbet@lwn.net>
Sun, 22 Mar 2026 20:47:53 +0000 (14:47 -0600)
Add a comment before the step-by-step guide explaining that the document
is best viewed in the rendered form, as there the internal links will
work that later patches will add.

Signed-off-by: Thorsten Leemhuis <linux@leemhuis.info>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <f8e3577df4a231b66e8f638f7b41614bf15b49ab.1773750701.git.linux@leemhuis.info>

Documentation/admin-guide/reporting-issues.rst

index a68e6d9092747161273e78e60e2588bf5ba19839..049dd9b663513dd8e55883db919c317afc7d429c 100644 (file)
@@ -48,6 +48,16 @@ Once the report is out, answer any questions that come up and help where you
 can. That includes keeping the ball rolling by occasionally retesting with newer
 releases and sending a status update afterwards.
 
+..
+   Note: If you see this note, you are reading the text's source file. You
+   might want to switch to a rendered version: It makes it a lot easier to
+   read and navigate this document -- especially when you want to look something
+   up in the reference section, then jump back to where you left off.
+..
+   Find the latest rendered version of this text here:
+   https://docs.kernel.org/admin-guide/reporting-issues.html
+
+
 Step-by-step guide how to report issues to the kernel maintainers
 =================================================================