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.
While at it change the double quotes in the license hint at the end of the document into single quotes, which is the preferred style. Signed-off-by: Thorsten Leemhuis <[email protected]> --- Documentation/admin-guide/reporting-issues.rst | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/Documentation/admin-guide/reporting-issues.rst b/Documentation/admin-guide/reporting-issues.rst index a68e6d90927471..3bc47afaf85ea0 100644 --- a/Documentation/admin-guide/reporting-issues.rst +++ b/Documentation/admin-guide/reporting-issues.rst @@ -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 ================================================================= @@ -1748,13 +1758,13 @@ art will lay some groundwork to improve the situation over time. you spot a typo or small mistake, feel free to let him know directly and he'll fix it. You are free to do the same in a mostly informal way if you want to contribute changes to the text, but for copyright reasons please CC - [email protected] and "sign-off" your contribution as - Documentation/process/submitting-patches.rst outlines in the section "Sign - your work - the Developer's Certificate of Origin". + [email protected] and 'sign-off' your contribution as + Documentation/process/submitting-patches.rst outlines in the section 'Sign + your work - the Developer's Certificate of Origin'. .. This text is available under GPL-2.0+ or CC-BY-4.0, as stated at the top of the file. If you want to distribute this text under CC-BY-4.0 only, - please use "The Linux kernel developers" for author attribution and link + please use 'The Linux kernel developers' for author attribution and link this as source: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/admin-guide/reporting-issues.rst .. -- 2.51.0
