[libcxx-commits] [libcxx] [libc++][docs] Rewrite libc++ docs to md [2/2] (PR #234088)

Sachin 🗲 via libcxx-commits libcxx-commits at lists.llvm.org
Thu Oct 22 04:05:20 PDT 2026


https://github.com/s4chinjha updated https://github.com/llvm/llvm-project/pull/234088

>From 08cdcebd3c63547a0fbe76e6e99cd29d33389b8e Mon Sep 17 00:00:00 2001
From: s4chinjha <s4chinjha at gmail.com>
Date: Wed, 21 Oct 2026 01:15:39 +0530
Subject: [PATCH 1/2] [libc++][docs] Rename remaining rst docs to md

---
 .../Helpers/{ReleaseNotesTemplate.rst => ReleaseNotesTemplate.md} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename libcxx/docs/Helpers/{ReleaseNotesTemplate.rst => ReleaseNotesTemplate.md} (100%)

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

>From 547516c01a487aa75e742634fc6a884baccbc5da Mon Sep 17 00:00:00 2001
From: s4chinjha <s4chinjha at gmail.com>
Date: Wed, 21 Oct 2026 01:22:33 +0530
Subject: [PATCH 2/2] [libc++][docs] Rewrite remaining docs to md

---
 libcxx/docs/Helpers/ReleaseNotesTemplate.md | 65 ++++++++-------------
 1 file changed, 25 insertions(+), 40 deletions(-)

diff --git a/libcxx/docs/Helpers/ReleaseNotesTemplate.md b/libcxx/docs/Helpers/ReleaseNotesTemplate.md
index cc4468cf3cc4f3..8e08dd967d2c9b 100644
--- a/libcxx/docs/Helpers/ReleaseNotesTemplate.md
+++ b/libcxx/docs/Helpers/ReleaseNotesTemplate.md
@@ -1,62 +1,47 @@
-===========================================
-Libc++ XX.YY.ZZ (In-Progress) Release Notes
-===========================================
+# Libc++ XX.YY.ZZ (In-Progress) Release Notes
 
-.. contents::
-   :local:
-   :depth: 2
+```{contents}
+:depth: 2
+:local: true
+```
 
-Written by the :doc:`Libc++ Team </index>`
+Written by the {doc}`Libc++ Team </index>`
 
-.. warning::
+:::{warning}
+These are in-progress notes for the upcoming libc++ XX.YY.ZZ release.
+Release notes for previous releases can be found on
+[the Download Page](https://releases.llvm.org/download.html).
+:::
 
-   These are in-progress notes for the upcoming libc++ XX.YY.ZZ release.
-   Release notes for previous releases can be found on
-   `the Download Page <https://releases.llvm.org/download.html>`_.
-
-Introduction
-============
+## Introduction
 
 This document contains the release notes for the libc++ C++ Standard Library,
 part of the LLVM Compiler Infrastructure, release XX.YY.ZZ. Here we describe the
 status of libc++ in some detail, including major improvements from the previous
-release and new feature work. For the general LLVM release notes, see `the LLVM
-documentation <https://llvm.org/docs/ReleaseNotes.html>`_. All LLVM releases may
-be downloaded from the `LLVM releases web site <https://llvm.org/releases/>`_.
+release and new feature work. For the general LLVM release notes, see [the LLVM
+documentation](https://llvm.org/docs/ReleaseNotes.html). All LLVM releases may
+be downloaded from the [LLVM releases web site](https://llvm.org/releases/).
 
-For more information about libc++, please see the :doc:`Libc++ Web Site
-</index>` or the `LLVM Web Site <https://llvm.org>`_.
+For more information about libc++, please see the {doc}`Libc++ Web Site
+</index>` or the [LLVM Web Site](https://llvm.org).
 
 Note that if you are reading this file from a Git checkout or the
 main Libc++ web page, this document applies to the *next* release, not
 the current one. To see the release notes for a specific release, please
-see the `releases page <https://llvm.org/releases/>`_.
-
-What's New in Libc++ XX.YY.ZZ?
-==============================
-
-
-Implemented Papers
-------------------
+see the [releases page](https://llvm.org/releases/).
 
+## What's New in Libc++ XX.YY.ZZ?
 
-Improvements and New Features
------------------------------
+### Implemented Papers
 
+### Improvements and New Features
 
-Deprecations and Removals
--------------------------
+### Deprecations and Removals
 
-
-Upcoming Deprecations and Removals
-----------------------------------
+### Upcoming Deprecations and Removals
 
 NOTE: THIS SHOULD BE POPULATED FROM THE PREVIOUS RELEASE'S UPCOMING DEPRECATIONS AND REMOVALS FOR THE NEXT-NEXT RELEASE (IF ANY)
 
-ABI Affecting Changes
----------------------
-
-
-Build System Changes
---------------------
+### ABI Affecting Changes
 
+### Build System Changes



More information about the libcxx-commits mailing list