[all-commits] [llvm/llvm-project] 28d90b: [docs] Replace llvm.org/docs links with project li...

[Reid Kleckner via All-commits]

  Branch: refs/heads/main
  Home:   https://github.com/llvm/llvm-project
  Commit: 28d90b4824d5b485c891b1fcfc5b79add6052916
      https://github.com/llvm/llvm-project/commit/28d90b4824d5b485c891b1fcfc5b79add6052916
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-09-23 (Wed, 23 Sep 2026)

  Changed paths:
    M llvm/docs/AIToolPolicy.md
    M llvm/docs/AMDGPU/DeveloperGuideline.rst
    M llvm/docs/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack.md
    M llvm/docs/AMDGPUDwarfExtensionsForHeterogeneousDebugging.rst
    M llvm/docs/AMDGPUUsage.rst
    M llvm/docs/AdminTasks.md
    M llvm/docs/CodeGenerator.md
    M llvm/docs/CodingStandards.md
    M llvm/docs/CommandGuide/llvm-ir2vec.md
    M llvm/docs/CommandGuide/llvm-remarkutil.md
    M llvm/docs/CompileCudaWithLLVM.md
    M llvm/docs/DeveloperPolicy.md
    M llvm/docs/ExtendingLLVM.md
    M llvm/docs/GettingInvolved.md
    M llvm/docs/GettingStarted.md
    M llvm/docs/GitHub.md
    M llvm/docs/GitRepositoryPolicy.md
    M llvm/docs/GwpAsan.rst
    M llvm/docs/HowToAddABuilder.rst
    M llvm/docs/HowToBuildWithPGO.md
    M llvm/docs/HowToCrossCompileBuiltinsOnArm.md
    M llvm/docs/HowToCrossCompileLLVM.md
    M llvm/docs/InstrProfileFormat.md
    M llvm/docs/InstrRefDebugInfo.md
    M llvm/docs/LangRef.md
    M llvm/docs/Lexicon.md
    M llvm/docs/LoopTerminology.md
    M llvm/docs/MIRLangRef.md
    M llvm/docs/MLGO.rst
    M llvm/docs/MarkdownQuickstartTemplate.md
    M llvm/docs/MeetupGuidelines.md
    M llvm/docs/MemProf.md
    M llvm/docs/MergeFunctions.md
    M llvm/docs/NVPTXUsage.md
    M llvm/docs/OpaquePointers.md
    M llvm/docs/PointerAuth.md
    M llvm/docs/ProgrammersManual.md
    M llvm/docs/Proposals/VectorPredication.md
    M llvm/docs/QualGroup.md
    M llvm/docs/RISCV/RISCVVectorExtension.md
    M llvm/docs/ReleaseNotes.md
    M llvm/docs/RemoveDIsDebugInfo.md
    M llvm/docs/SandboxIR.md
    M llvm/docs/ScudoHardenedAllocator.md
    M llvm/docs/SecurityTransparencyReports.md
    M llvm/docs/SphinxQuickstartTemplate.md
    M llvm/docs/SupportPolicy.md
    M llvm/docs/TestingGuide.md
    M llvm/docs/tutorial/BuildingAJIT1.md
    M llvm/docs/tutorial/BuildingAJIT4.md
    M llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl09.md
    M utils/docs/llvm_sphinx/ext/absolute_links.py
    M utils/docs/llvm_sphinx/ext/absolute_links_test/conf.py
    M utils/docs/llvm_sphinx/ext/absolute_links_test/markdown.md
    M utils/docs/llvm_sphinx/ext/absolute_links_test/rest.rst
    A utils/docs/llvm_sphinx/ext/absolute_links_test/static.html

  Log Message:
  -----------
  [docs] Replace llvm.org/docs links with project links (#222506)

Replace same-project absolute http* URLs with project-local markdown
links. This lets Sphinx validate the targets and keeps local
documentation builds and archived release documentation self-contained.

During the review of the PR, we decided that we prefer markdown-native
links with section header slugs for cross-referencing, when possible.
This is maximally compatible with other markdown renderers, like github.
This has been added to the sphinx quickstart guide, which serves as our
project local Sphinx style guide.

The absolute link checker has been updated to guide people towards the
correct link cross-ref syntax, warning on discouraged constructs.

Part of #214861

Assisted-by: codex



To unsubscribe from these emails, change your notification settings at https://github.com/llvm/llvm-project/settings/notifications