[libc-commits] [libc] [docs] Rename selected libc docs to Markdown (PR #208354)

[Reid Kleckner via libc-commits]

https://github.com/rnk created https://github.com/llvm/llvm-project/pull/208354

Tracking issue: https://github.com/llvm/llvm-project/issues/201242
Migration guide docs: https://llvm.org/docs/SphinxQuickstartTemplate.html#markdown-migration-guidelines
RFC: https://discourse.llvm.org/t/rfc-make-myst-markdown-the-llvm-docs-format-rip-rest/90840

This is the initial straight rename commit. It will probably break the docs build, but it has to be a separate PR for blame preservation purposes.

>From b853757630328890c2f1a663a2401656795f39d2 Mon Sep 17 00:00:00 2001
From: Reid Kleckner <rkleckner at nvidia.com>
Date: Wed, 8 Jul 2026 23:37:50 +0000
Subject: [PATCH] [docs] Rename selected libc docs to Markdown

---
 libc/docs/{arch_support.rst => arch_support.md}                 | 0
 libc/docs/{build_and_test.rst => build_and_test.md}             | 0
 libc/docs/{build_concepts.rst => build_concepts.md}             | 0
 libc/docs/{compiler_support.rst => compiler_support.md}         | 0
 libc/docs/{contributing.rst => contributing.md}                 | 0
 libc/docs/dev/{building_docs.rst => building_docs.md}           | 0
 .../dev/{builtin_compatibility.rst => builtin_compatibility.md} | 0
 libc/docs/dev/{code_style.rst => code_style.md}                 | 0
 libc/docs/dev/{config_options.rst => config_options.md}         | 0
 libc/docs/dev/{entrypoints.rst => entrypoints.md}               | 0
 libc/docs/dev/{fuzzing.rst => fuzzing.md}                       | 0
 libc/docs/dev/{header_generation.rst => header_generation.md}   | 0
 .../{implementation_standard.rst => implementation_standard.md} | 0
 .../{implementing_a_function.rst => implementing_a_function.md} | 0
 libc/docs/dev/{index.rst => index.md}                           | 0
 libc/docs/dev/{modular_format.rst => modular_format.md}         | 0
 libc/docs/dev/{printf_behavior.rst => printf_behavior.md}       | 0
 libc/docs/dev/{source_tree_layout.rst => source_tree_layout.md} | 0
 ...syscall_wrapper_refactor.rst => syscall_wrapper_refactor.md} | 0
 libc/docs/dev/{undefined_behavior.rst => undefined_behavior.md} | 0
 libc/docs/index.rst                                             | 2 +-
 21 files changed, 1 insertion(+), 1 deletion(-)
 rename libc/docs/{arch_support.rst => arch_support.md} (100%)
 rename libc/docs/{build_and_test.rst => build_and_test.md} (100%)
 rename libc/docs/{build_concepts.rst => build_concepts.md} (100%)
 rename libc/docs/{compiler_support.rst => compiler_support.md} (100%)
 rename libc/docs/{contributing.rst => contributing.md} (100%)
 rename libc/docs/dev/{building_docs.rst => building_docs.md} (100%)
 rename libc/docs/dev/{builtin_compatibility.rst => builtin_compatibility.md} (100%)
 rename libc/docs/dev/{code_style.rst => code_style.md} (100%)
 rename libc/docs/dev/{config_options.rst => config_options.md} (100%)
 rename libc/docs/dev/{entrypoints.rst => entrypoints.md} (100%)
 rename libc/docs/dev/{fuzzing.rst => fuzzing.md} (100%)
 rename libc/docs/dev/{header_generation.rst => header_generation.md} (100%)
 rename libc/docs/dev/{implementation_standard.rst => implementation_standard.md} (100%)
 rename libc/docs/dev/{implementing_a_function.rst => implementing_a_function.md} (100%)
 rename libc/docs/dev/{index.rst => index.md} (100%)
 rename libc/docs/dev/{modular_format.rst => modular_format.md} (100%)
 rename libc/docs/dev/{printf_behavior.rst => printf_behavior.md} (100%)
 rename libc/docs/dev/{source_tree_layout.rst => source_tree_layout.md} (100%)
 rename libc/docs/dev/{syscall_wrapper_refactor.rst => syscall_wrapper_refactor.md} (100%)
 rename libc/docs/dev/{undefined_behavior.rst => undefined_behavior.md} (100%)

diff --git a/libc/docs/arch_support.rst b/libc/docs/arch_support.md
similarity index 100%
rename from libc/docs/arch_support.rst
rename to libc/docs/arch_support.md
diff --git a/libc/docs/build_and_test.rst b/libc/docs/build_and_test.md
similarity index 100%
rename from libc/docs/build_and_test.rst
rename to libc/docs/build_and_test.md
diff --git a/libc/docs/build_concepts.rst b/libc/docs/build_concepts.md
similarity index 100%
rename from libc/docs/build_concepts.rst
rename to libc/docs/build_concepts.md
diff --git a/libc/docs/compiler_support.rst b/libc/docs/compiler_support.md
similarity index 100%
rename from libc/docs/compiler_support.rst
rename to libc/docs/compiler_support.md
diff --git a/libc/docs/contributing.rst b/libc/docs/contributing.md
similarity index 100%
rename from libc/docs/contributing.rst
rename to libc/docs/contributing.md
diff --git a/libc/docs/dev/building_docs.rst b/libc/docs/dev/building_docs.md
similarity index 100%
rename from libc/docs/dev/building_docs.rst
rename to libc/docs/dev/building_docs.md
diff --git a/libc/docs/dev/builtin_compatibility.rst b/libc/docs/dev/builtin_compatibility.md
similarity index 100%
rename from libc/docs/dev/builtin_compatibility.rst
rename to libc/docs/dev/builtin_compatibility.md
diff --git a/libc/docs/dev/code_style.rst b/libc/docs/dev/code_style.md
similarity index 100%
rename from libc/docs/dev/code_style.rst
rename to libc/docs/dev/code_style.md
diff --git a/libc/docs/dev/config_options.rst b/libc/docs/dev/config_options.md
similarity index 100%
rename from libc/docs/dev/config_options.rst
rename to libc/docs/dev/config_options.md
diff --git a/libc/docs/dev/entrypoints.rst b/libc/docs/dev/entrypoints.md
similarity index 100%
rename from libc/docs/dev/entrypoints.rst
rename to libc/docs/dev/entrypoints.md
diff --git a/libc/docs/dev/fuzzing.rst b/libc/docs/dev/fuzzing.md
similarity index 100%
rename from libc/docs/dev/fuzzing.rst
rename to libc/docs/dev/fuzzing.md
diff --git a/libc/docs/dev/header_generation.rst b/libc/docs/dev/header_generation.md
similarity index 100%
rename from libc/docs/dev/header_generation.rst
rename to libc/docs/dev/header_generation.md
diff --git a/libc/docs/dev/implementation_standard.rst b/libc/docs/dev/implementation_standard.md
similarity index 100%
rename from libc/docs/dev/implementation_standard.rst
rename to libc/docs/dev/implementation_standard.md
diff --git a/libc/docs/dev/implementing_a_function.rst b/libc/docs/dev/implementing_a_function.md
similarity index 100%
rename from libc/docs/dev/implementing_a_function.rst
rename to libc/docs/dev/implementing_a_function.md
diff --git a/libc/docs/dev/index.rst b/libc/docs/dev/index.md
similarity index 100%
rename from libc/docs/dev/index.rst
rename to libc/docs/dev/index.md
diff --git a/libc/docs/dev/modular_format.rst b/libc/docs/dev/modular_format.md
similarity index 100%
rename from libc/docs/dev/modular_format.rst
rename to libc/docs/dev/modular_format.md
diff --git a/libc/docs/dev/printf_behavior.rst b/libc/docs/dev/printf_behavior.md
similarity index 100%
rename from libc/docs/dev/printf_behavior.rst
rename to libc/docs/dev/printf_behavior.md
diff --git a/libc/docs/dev/source_tree_layout.rst b/libc/docs/dev/source_tree_layout.md
similarity index 100%
rename from libc/docs/dev/source_tree_layout.rst
rename to libc/docs/dev/source_tree_layout.md
diff --git a/libc/docs/dev/syscall_wrapper_refactor.rst b/libc/docs/dev/syscall_wrapper_refactor.md
similarity index 100%
rename from libc/docs/dev/syscall_wrapper_refactor.rst
rename to libc/docs/dev/syscall_wrapper_refactor.md
diff --git a/libc/docs/dev/undefined_behavior.rst b/libc/docs/dev/undefined_behavior.md
similarity index 100%
rename from libc/docs/dev/undefined_behavior.rst
rename to libc/docs/dev/undefined_behavior.md
diff --git a/libc/docs/index.rst b/libc/docs/index.rst
index 61472da0c5937..d0b6579c79e89 100644
--- a/libc/docs/index.rst
+++ b/libc/docs/index.rst
@@ -94,7 +94,7 @@ levels.  See :doc:`contributing` to learn how to help.
 
    contributing
    build_and_test
-   dev/index.rst
+   dev/index.md
    porting
    Maintainers