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

[via libcxx-commits]

llvmorg-github-actions[bot] wrote:


<!--LLVM PR SUMMARY COMMENT-->

@llvm/pr-subscribers-libcxx

Author: Sachin 🗲 (s4chinjha)

<details>
<summary>Changes</summary>

Tracking issue: [#<!-- -->201242](https://github.com/llvm/llvm-project/issues/201242)

See the [migration guide](https://llvm.org/docs/SphinxQuickstartTemplate.html#markdown-migration-guidelines) for more information.

this is the second part of migrating the remaining libc++ file from rst to md
the content conversion is provided by this pr, following the rename in the previous pr

this was prepared with rnk's fork of rst2myst and LLM-assisted cleanup.
I manually verified that the documentation renders as expected

Depends on [#<!-- -->233994](https://github.com/llvm/llvm-project/pull/233994)

the first commit is from the base pr (rename), the second commit contains the content conversion

---
Full diff: https://github.com/llvm/llvm-project/pull/234088.diff


2 Files Affected:

- (added) libcxx/docs/Helpers/ReleaseNotesTemplate.md (+47) 
- (removed) libcxx/docs/Helpers/ReleaseNotesTemplate.rst (-62) 


``````````diff
diff --git a/libcxx/docs/Helpers/ReleaseNotesTemplate.md b/libcxx/docs/Helpers/ReleaseNotesTemplate.md
new file mode 100644
index 00000000000000..8e08dd967d2c9b
--- /dev/null
+++ b/libcxx/docs/Helpers/ReleaseNotesTemplate.md
@@ -0,0 +1,47 @@
+# Libc++ XX.YY.ZZ (In-Progress) Release Notes
+
+```{contents}
+:depth: 2
+:local: true
+```
+
+Written by the {doc}`Libc++ Team </index>`
+
+:::{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).
+:::
+
+## 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/).
+
+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
+
+### Improvements and New Features
+
+### 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
diff --git a/libcxx/docs/Helpers/ReleaseNotesTemplate.rst b/libcxx/docs/Helpers/ReleaseNotesTemplate.rst
deleted file mode 100644
index cc4468cf3cc4f3..00000000000000
--- a/libcxx/docs/Helpers/ReleaseNotesTemplate.rst
+++ /dev/null
@@ -1,62 +0,0 @@
-===========================================
-Libc++ XX.YY.ZZ (In-Progress) Release Notes
-===========================================
-
-.. contents::
-   :local:
-   :depth: 2
-
-Written by the :doc:`Libc++ Team </index>`
-
-.. 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>`_.
-
-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/>`_.
-
-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
-------------------
-
-
-Improvements and New Features
------------------------------
-
-
-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
---------------------
-

``````````

</details>


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