On Fri, 29 Aug 2025, Bagas Sanjaya <bagasdotme@xxxxxxxxx> wrote: > Cross-references to other docs (so-called internal links) are typically > done following Documentation/doc-guide/sphinx.rst: either simply > write the target docs (preferred) or use :doc: or :ref: reST directives > (for use-cases like having anchor text or cross-referencing sections). > In some places, however, links to https://www.kernel.org/doc > are used instead (outgoing, external links), owing inconsistency as > these requires Internet connection only to see docs that otherwise > can be accessed locally (after building with ``make htmldocs``). > > Convert such external links to internal links. Note that this does not > cover docs.kernel.org links nor touching Documentation/tools (as > docs containing external links are in manpages). FWIW, I'd much prefer using :ref: on rst anchors (that automatically pick the link text from the target heading) instead of manually adding link texts and file references. i.e. .. _some_target: Heading After Some Target ========================= See :ref:`some_target`. Will generate "See Heading After Some Target". BR, Jani. -- Jani Nikula, Intel
