[llvm-branch-commits] [llvm] [docs] Finish MyST migration for PDB, DirectX, and GlobalISel docs (PR #217159)

[Justin Bogner via llvm-branch-commits]

================
@@ -684,104 +682,108 @@ bit in the mask vector identifies one column of a patch constant input and a
 column of an output. A value of 1 means the output is impacted by the primitive
 input.
 
-Root Signature (RTS0) Part
---------------------------
-.. _RTS0:
+### Root Signature (RTS0) Part
 
-The Root Signature data defines the shader's resource interface with Direct3D 
-12, specifying what resources the shader needs to access and how they're 
-organized and bound to the pipeline. 
+(RTS0)=
 
-The RTS0 part comprises three data structures: ``RootSignatureHeader``, 
-``RootParameters`` and ``StaticSamplers``. The details of each will be described 
-in the following sections. All ``RootParameters`` will be serialized following 
+The Root Signature data defines the shader's resource interface with Direct3D
+12, specifying what resources the shader needs to access and how they're
+organized and bound to the pipeline.
+
+The RTS0 part comprises three data structures: `RootSignatureHeader`,
+`RootParameters` and `StaticSamplers`. The details of each will be described
+in the following sections. All `RootParameters` will be serialized following
 the order they were defined in the metadata representation.
 
-The table below summarizes the data being serialized as well as it's size. The 
-details of it part will be discussed in further details on the next sections 
+The table below summarizes the data being serialized as well as it's size. The
+details of it part will be discussed in further details on the next sections
 of this document.
 
-======================== =========================================== =============================
-Part Name                Size In Bytes                                 Maximum number of Instances 
-======================== =========================================== =============================
-Root Signature Header    24                                          1               
-Root Parameter Headers   12                                          Many              
-Root Parameter           ================================ ===        Many
-                         Root Constants                   12                                      
-                         Root Descriptor Version 1.0      8                                      
-                         Root Descriptor Version 1.1      12                                      
-                         Descriptors Tables Version 1.0   20                                     
-                         Descriptors Tables Version 1.1   24                                      
-                         ================================ ===       
-                                             
-Static Samplers          52                                          Many              
-======================== =========================================== =============================
-
-
-Root Signature Header
-~~~~~~~~~~~~~~~~~~~~~
+:::{list-table}
+:header-rows: 1
+
+* - Part Name
+  - Size In Bytes
+  - Maximum number of Instances
+* - Root Signature Header
+  - 24
+  - 1
+* - Root Parameter Headers
+  - 12
+  - Many
+* - Root Parameter
+  - | Root Parameter Type | Size |
+    | --- | --- |
+    | Root Constants | 12 |
+    | Root Descriptor Version 1.0 | 8 |
+    | Root Descriptor Version 1.1 | 12 |
+    | Descriptors Tables Version 1.0 | 20 |
+    | Descriptors Tables Version 1.1 | 24 |
----------------
bogner wrote:

It's kind of wild to me that it converted the larger table here to a `list-table` but left the nested table as a markdown style table, but I guess it works. It'd be nice to format it so it's readable in text though:

```suggestion
  - | Root Parameter Type            | Size |
    |--------------------------------|------|
    | Root Constants                 | 12   |
    | Root Descriptor Version 1.0    | 8    |
    | Root Descriptor Version 1.1    | 12   |
    | Descriptors Tables Version 1.0 | 20   |
    | Descriptors Tables Version 1.1 | 24   |
```

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