[all-commits] [llvm/llvm-project] 62be22: [docs] Rename 20 popular LLVM docs .rst -> .md

Reid Kleckner via All-commits all-commits at lists.llvm.org
Wed Jun 3 15:31:22 PDT 2026


  Branch: refs/heads/users/rnk/llvm-md-2b
  Home:   https://github.com/llvm/llvm-project
  Commit: 62be22ac12116dcdcfa327a0c6b08c64e31befd8
      https://github.com/llvm/llvm-project/commit/62be22ac12116dcdcfa327a0c6b08c64e31befd8
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-06-03 (Wed, 03 Jun 2026)

  Changed paths:
    M llvm/README.txt
    A llvm/docs/CMake.md
    R llvm/docs/CMake.rst
    A llvm/docs/CodeGenerator.md
    R llvm/docs/CodeGenerator.rst
    A llvm/docs/CodingStandards.md
    R llvm/docs/CodingStandards.rst
    A llvm/docs/CommandGuide/index.md
    R llvm/docs/CommandGuide/index.rst
    A llvm/docs/Contributing.md
    R llvm/docs/Contributing.rst
    A llvm/docs/DeveloperPolicy.md
    R llvm/docs/DeveloperPolicy.rst
    A llvm/docs/GettingInvolved.md
    R llvm/docs/GettingInvolved.rst
    A llvm/docs/GettingStarted.md
    R llvm/docs/GettingStarted.rst
    A llvm/docs/GettingStartedTutorials.md
    R llvm/docs/GettingStartedTutorials.rst
    A llvm/docs/GitHub.md
    R llvm/docs/GitHub.rst
    M llvm/docs/GitRepositoryPolicy.md
    M llvm/docs/InstrRefDebugInfo.md
    A llvm/docs/Passes.md
    R llvm/docs/Passes.rst
    A llvm/docs/ProgrammersManual.md
    R llvm/docs/ProgrammersManual.rst
    A llvm/docs/RFCProcess.md
    R llvm/docs/RFCProcess.rst
    A llvm/docs/Reference.md
    R llvm/docs/Reference.rst
    M llvm/docs/RemoveDIsDebugInfo.md
    A llvm/docs/SourceLevelDebugging.md
    R llvm/docs/SourceLevelDebugging.rst
    M llvm/docs/SphinxQuickstartTemplate.md
    A llvm/docs/TableGen/index.md
    R llvm/docs/TableGen/index.rst
    A llvm/docs/TestingGuide.md
    R llvm/docs/TestingGuide.rst
    A llvm/docs/UserGuides.md
    R llvm/docs/UserGuides.rst
    A llvm/docs/WritingAnLLVMBackend.md
    R llvm/docs/WritingAnLLVMBackend.rst
    A llvm/docs/WritingAnLLVMNewPMPass.md
    R llvm/docs/WritingAnLLVMNewPMPass.rst
    A llvm/docs/WritingAnLLVMPass.md
    R llvm/docs/WritingAnLLVMPass.rst
    M llvm/docs/conf.py
    A llvm/docs/index.md
    R llvm/docs/index.rst
    M llvm/lib/DebugInfo/DWARF/DWARFAcceleratorTable.cpp
    M llvm/lib/IR/DebugInfo.cpp
    M llvm/tools/reduce-chunk-list/reduce-chunk-list.cpp
    M llvm/utils/lit/tests/Inputs/shtest-define/examples/param-subst.txt

  Log Message:
  -----------
  [docs] Rename 20 popular LLVM docs .rst -> .md

Update filename references, but leave the docs with reST syntax to
ensure rename detection works.

I updated filename references so that the docs build to pass premerge
checks.


  Commit: 6afd7c701fb5ad1135aa4fbb66653d2e49bc6582
      https://github.com/llvm/llvm-project/commit/6afd7c701fb5ad1135aa4fbb66653d2e49bc6582
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-06-03 (Wed, 03 Jun 2026)

  Changed paths:
    M llvm/docs/CMake.md
    M llvm/docs/CodeGenerator.md
    M llvm/docs/CodingStandards.md
    M llvm/docs/CommandGuide/index.md
    M llvm/docs/Contributing.md
    M llvm/docs/DeveloperPolicy.md
    M llvm/docs/GettingInvolved.md
    M llvm/docs/GettingStarted.md
    M llvm/docs/GettingStartedTutorials.md
    M llvm/docs/GitHub.md
    M llvm/docs/Passes.md
    M llvm/docs/ProgrammersManual.md
    M llvm/docs/RFCProcess.md
    M llvm/docs/Reference.md
    M llvm/docs/SourceLevelDebugging.md
    M llvm/docs/TableGen/index.md
    M llvm/docs/TestingGuide.md
    M llvm/docs/UserGuides.md
    M llvm/docs/WritingAnLLVMBackend.md
    M llvm/docs/WritingAnLLVMNewPMPass.md
    M llvm/docs/WritingAnLLVMPass.md
    M llvm/docs/conf.py
    M llvm/docs/index.md

  Log Message:
  -----------
  [docs] Migrate 22 popular LLVM docs to MyST

This was done with LLM assistance.

I opened all 22 docs in a browser and scrolled through them, catching
and fixing a few errors.


  Commit: e3c0f105db99810cb6888e7299f17b0398ebb3df
      https://github.com/llvm/llvm-project/commit/e3c0f105db99810cb6888e7299f17b0398ebb3df
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-06-03 (Wed, 03 Jun 2026)

  Changed paths:
    M llvm/docs/CMake.md
    M llvm/docs/DeveloperPolicy.md

  Log Message:
  -----------
  Remove many pandoc-isms from DeveloperPolicy and CMake


  Commit: b9b7fce10901ec52a304509fd81fd7b10fba962e
      https://github.com/llvm/llvm-project/commit/b9b7fce10901ec52a304509fd81fd7b10fba962e
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-06-03 (Wed, 03 Jun 2026)

  Changed paths:
    M llvm/docs/CMake.md

  Log Message:
  -----------
  Apply suggestion manually


  Commit: 7d66dd8e5cb3a7f76e3806639f0ab176673020d4
      https://github.com/llvm/llvm-project/commit/7d66dd8e5cb3a7f76e3806639f0ab176673020d4
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-06-03 (Wed, 03 Jun 2026)

  Changed paths:
    M llvm/docs/DeveloperPolicy.md

  Log Message:
  -----------
  Massage the whitespace further, keep the old wrapping in more bullet lists


  Commit: 26125ac791fe98181366f56391c766d75718bab5
      https://github.com/llvm/llvm-project/commit/26125ac791fe98181366f56391c766d75718bab5
  Author: Reid Kleckner <rkleckner at nvidia.com>
  Date:   2026-06-03 (Wed, 03 Jun 2026)

  Changed paths:
    M llvm/docs/AliasAnalysis.md
    M llvm/docs/Atomics.md
    M llvm/docs/BitCodeFormat.md
    M llvm/docs/CommandLine.md
    M llvm/docs/CompilerWriterInfo.md
    M llvm/docs/Coroutines.md
    M llvm/docs/CoverageMappingFormat.md
    M llvm/docs/DebuggingLLVM.md
    M llvm/docs/ExceptionHandling.md
    M llvm/docs/Extensions.md
    M llvm/docs/FAQ.md
    M llvm/docs/GarbageCollection.md
    M llvm/docs/GettingStartedVS.md
    M llvm/docs/InstrProfileFormat.md
    M llvm/docs/Lexicon.md
    M llvm/docs/LibFuzzer.md
    M llvm/docs/LoopTerminology.md
    M llvm/docs/MIRLangRef.md
    M llvm/docs/MemorySSA.md
    M llvm/docs/NewPassManager.md

  Log Message:
  -----------
  [docs] Migrate 20 LLVM docs to markdown

Files:
- DebuggingLLVM.md
- FAQ.md
- CompilerWriterInfo.md
- GettingStartedVS.md
- NewPassManager.md
- MemorySSA.md
- LoopTerminology.md
- Lexicon.md
- MIRLangRef.md
- CoverageMappingFormat.md
- InstrProfileFormat.md
- BitCodeFormat.md
- Atomics.md
- GarbageCollection.md
- AliasAnalysis.md
- LibFuzzer.md
- Extensions.md
- CommandLine.md
- ExceptionHandling.md
- Coroutines.md

Tracking issue: #201242


Compare: https://github.com/llvm/llvm-project/compare/69cb7c4c904c...26125ac791fe

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


More information about the All-commits mailing list