[llvm-branch-commits] [llvm] [docs] Migrate 22 popular LLVM docs to MyST (PR #201244)

[James Henderson via llvm-branch-commits]

================
@@ -13,96 +14,91 @@ research projects.
 Similarly, documentation is broken down into several high-level groupings
 targeted at different audiences:
 
-LLVM Design & Overview
-======================
+# LLVM Design & Overview
 
 Several introductory papers and presentations.
 
-.. toctree::
-   :hidden:
+```{toctree}
+:hidden:
 
-   FAQ
-   Lexicon
+FAQ
+Lexicon
+```
 
-:doc:`FAQ`
-  Frequently asked questions.
+{doc}`FAQ`
+: Frequently asked questions.
 
-:doc:`Lexicon`
-  Glossary.
+{doc}`Lexicon`
+: Glossary.
 
-`Introduction to the LLVM Compiler`__
-  Presentation providing a users introduction to LLVM.
+[Introduction to the LLVM Compiler]
+: Presentation providing a users introduction to LLVM.
 
-  .. __: https://llvm.org/pubs/2008-10-04-ACAT-LLVM-Intro.html
-
-`Intro to LLVM`__
-  A chapter from the book "The Architecture of Open Source Applications" that
+[Intro to LLVM]
+: A chapter from the book "The Architecture of Open Source Applications" that
   describes high-level design decisions that shaped LLVM.
 
-  .. __: http://www.aosabook.org/en/llvm.html
-
-
-`LLVM: A Compilation Framework for Lifelong Program Analysis & Transformation`__
-  Design overview.
-
-  .. __: https://llvm.org/pubs/2004-01-30-CGO-LLVM.html
+[LLVM: A Compilation Framework for Lifelong Program Analysis & Transformation][llvm-lifelong]
+: Design overview.
 
-`LLVM: An Infrastructure for Multi-Stage Optimization`__
-  More details (quite old now).
+[LLVM: An Infrastructure for Multi-Stage Optimization][llvm-multi-stage]
+: More details (quite old now).
 
-  .. __: https://llvm.org/pubs/2002-12-LattnerMSThesis.html
+[Introduction to the LLVM Compiler]: https://llvm.org/pubs/2008-10-04-ACAT-LLVM-Intro.html
+[Intro to LLVM]: http://www.aosabook.org/en/llvm.html
+[llvm-lifelong]: https://llvm.org/pubs/2004-01-30-CGO-LLVM.html
+[llvm-multi-stage]: https://llvm.org/pubs/2002-12-LattnerMSThesis.html
----------------
jh7370 wrote:

I'm not especially familiar with some Markdown details. Is this syntax correct? It seems a little unusual to me.

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