[libcxx-commits] [libcxx] 0f5a125 - [libc++][docs] Rename documentation files to Markdown (batch 1) (#221512)

[via libcxx-commits]

Author: Reid Kleckner
Date: 2026-09-27T08:53:20-07:00
New Revision: 0f5a125bad555b6bf4bb2318b9f1ea7936adf19d

URL: https://github.com/llvm/llvm-project/commit/0f5a125bad555b6bf4bb2318b9f1ea7936adf19d
DIFF: https://github.com/llvm/llvm-project/commit/0f5a125bad555b6bf4bb2318b9f1ea7936adf19d.diff

LOG: [libc++][docs] Rename documentation files to Markdown (batch 1) (#221512)

Tracking issue: #201242
See the [migration guide] for more information. 

[migration guide]:
https://llvm.org/docs/SphinxQuickstartTemplate.html#markdown-migration-guidelines

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.

Added: 
    libcxx/docs/ABIGuarantees.md
    libcxx/docs/AddingNewCIJobs.md
    libcxx/docs/CodingGuidelines.md
    libcxx/docs/Contributing.md
    libcxx/docs/Contributing/NewStandardProcedure.md
    libcxx/docs/Contributing/PostMeetingProcedure.md
    libcxx/docs/Contributing/ReleaseProcedure.md
    libcxx/docs/DesignDocs/ABIVersioning.md
    libcxx/docs/DesignDocs/AtomicDesign.md
    libcxx/docs/DesignDocs/CapturingConfigInfo.md
    libcxx/docs/DesignDocs/ExperimentalFeatures.md
    libcxx/docs/DesignDocs/ExtendedCXX03Support.md
    libcxx/docs/DesignDocs/FeatureTestMacros.md
    libcxx/docs/DesignDocs/FileTimeType.md
    libcxx/docs/DesignDocs/HeaderRemovalPolicy.md

Modified: 
    libcxx/include/__configuration/abi.h

Removed: 
    libcxx/docs/ABIGuarantees.rst
    libcxx/docs/AddingNewCIJobs.rst
    libcxx/docs/CodingGuidelines.rst
    libcxx/docs/Contributing.rst
    libcxx/docs/Contributing/NewStandardProcedure.rst
    libcxx/docs/Contributing/PostMeetingProcedure.rst
    libcxx/docs/Contributing/ReleaseProcedure.rst
    libcxx/docs/DesignDocs/ABIVersioning.rst
    libcxx/docs/DesignDocs/AtomicDesign.rst
    libcxx/docs/DesignDocs/CapturingConfigInfo.rst
    libcxx/docs/DesignDocs/ExperimentalFeatures.rst
    libcxx/docs/DesignDocs/ExtendedCXX03Support.rst
    libcxx/docs/DesignDocs/FeatureTestMacros.rst
    libcxx/docs/DesignDocs/FileTimeType.rst
    libcxx/docs/DesignDocs/HeaderRemovalPolicy.rst


################################################################################
diff  --git a/libcxx/docs/ABIGuarantees.rst b/libcxx/docs/ABIGuarantees.md
similarity index 100%
rename from libcxx/docs/ABIGuarantees.rst
rename to libcxx/docs/ABIGuarantees.md

diff  --git a/libcxx/docs/AddingNewCIJobs.rst b/libcxx/docs/AddingNewCIJobs.md
similarity index 100%
rename from libcxx/docs/AddingNewCIJobs.rst
rename to libcxx/docs/AddingNewCIJobs.md

diff  --git a/libcxx/docs/CodingGuidelines.rst b/libcxx/docs/CodingGuidelines.md
similarity index 100%
rename from libcxx/docs/CodingGuidelines.rst
rename to libcxx/docs/CodingGuidelines.md

diff  --git a/libcxx/docs/Contributing.rst b/libcxx/docs/Contributing.md
similarity index 100%
rename from libcxx/docs/Contributing.rst
rename to libcxx/docs/Contributing.md

diff  --git a/libcxx/docs/Contributing/NewStandardProcedure.rst b/libcxx/docs/Contributing/NewStandardProcedure.md
similarity index 100%
rename from libcxx/docs/Contributing/NewStandardProcedure.rst
rename to libcxx/docs/Contributing/NewStandardProcedure.md

diff  --git a/libcxx/docs/Contributing/PostMeetingProcedure.rst b/libcxx/docs/Contributing/PostMeetingProcedure.md
similarity index 100%
rename from libcxx/docs/Contributing/PostMeetingProcedure.rst
rename to libcxx/docs/Contributing/PostMeetingProcedure.md

diff  --git a/libcxx/docs/Contributing/ReleaseProcedure.rst b/libcxx/docs/Contributing/ReleaseProcedure.md
similarity index 100%
rename from libcxx/docs/Contributing/ReleaseProcedure.rst
rename to libcxx/docs/Contributing/ReleaseProcedure.md

diff  --git a/libcxx/docs/DesignDocs/ABIVersioning.rst b/libcxx/docs/DesignDocs/ABIVersioning.md
similarity index 100%
rename from libcxx/docs/DesignDocs/ABIVersioning.rst
rename to libcxx/docs/DesignDocs/ABIVersioning.md

diff  --git a/libcxx/docs/DesignDocs/AtomicDesign.rst b/libcxx/docs/DesignDocs/AtomicDesign.md
similarity index 100%
rename from libcxx/docs/DesignDocs/AtomicDesign.rst
rename to libcxx/docs/DesignDocs/AtomicDesign.md

diff  --git a/libcxx/docs/DesignDocs/CapturingConfigInfo.rst b/libcxx/docs/DesignDocs/CapturingConfigInfo.md
similarity index 100%
rename from libcxx/docs/DesignDocs/CapturingConfigInfo.rst
rename to libcxx/docs/DesignDocs/CapturingConfigInfo.md

diff  --git a/libcxx/docs/DesignDocs/ExperimentalFeatures.rst b/libcxx/docs/DesignDocs/ExperimentalFeatures.md
similarity index 100%
rename from libcxx/docs/DesignDocs/ExperimentalFeatures.rst
rename to libcxx/docs/DesignDocs/ExperimentalFeatures.md

diff  --git a/libcxx/docs/DesignDocs/ExtendedCXX03Support.rst b/libcxx/docs/DesignDocs/ExtendedCXX03Support.md
similarity index 100%
rename from libcxx/docs/DesignDocs/ExtendedCXX03Support.rst
rename to libcxx/docs/DesignDocs/ExtendedCXX03Support.md

diff  --git a/libcxx/docs/DesignDocs/FeatureTestMacros.rst b/libcxx/docs/DesignDocs/FeatureTestMacros.md
similarity index 100%
rename from libcxx/docs/DesignDocs/FeatureTestMacros.rst
rename to libcxx/docs/DesignDocs/FeatureTestMacros.md

diff  --git a/libcxx/docs/DesignDocs/FileTimeType.rst b/libcxx/docs/DesignDocs/FileTimeType.md
similarity index 100%
rename from libcxx/docs/DesignDocs/FileTimeType.rst
rename to libcxx/docs/DesignDocs/FileTimeType.md

diff  --git a/libcxx/docs/DesignDocs/HeaderRemovalPolicy.rst b/libcxx/docs/DesignDocs/HeaderRemovalPolicy.md
similarity index 100%
rename from libcxx/docs/DesignDocs/HeaderRemovalPolicy.rst
rename to libcxx/docs/DesignDocs/HeaderRemovalPolicy.md

diff  --git a/libcxx/include/__configuration/abi.h b/libcxx/include/__configuration/abi.h
index d44d072bf2aaf..86f59cb548a8f 100644
--- a/libcxx/include/__configuration/abi.h
+++ b/libcxx/include/__configuration/abi.h
@@ -50,12 +50,12 @@
 #endif
 
 #if _LIBCPP_ABI_VERSION >= 2
-// TODO: Move the description of the remaining ABI flags to ABIGuarantees.rst or remove them.
+// TODO: Move the description of the remaining ABI flags to ABIGuarantees.md or remove them.
 
 // According to the Standard, `bitset::operator[] const` returns bool
 #  define _LIBCPP_ABI_BITSET_VECTOR_BOOL_CONST_SUBSCRIPT_RETURN_BOOL
 
-// These flags are documented in ABIGuarantees.rst
+// These flags are documented in ABIGuarantees.md
 #  define _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
 #  define _LIBCPP_ABI_ATOMIC_WAIT_NATIVE_BY_SIZE
 #  define _LIBCPP_ABI_ENABLE_SHARED_PTR_TRIVIAL_ABI