[fidldoc] Updating fidldocs
diff --git a/sdk/fidl/fuchsia.auth.account/index.md b/sdk/fidl/fuchsia.auth.account/index.md
index ed5fbcb..b545fb2 100644
--- a/sdk/fidl/fuchsia.auth.account/index.md
+++ b/sdk/fidl/fuchsia.auth.account/index.md
@@ -1169,15 +1169,16 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.auth.account/account_manager.fidl#11">MAX_ACCOUNTS_PER_DEVICE</a></td>
             <td>
                     <code>128</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The maximum number of Fuchsia accounts that may be simultaneously provisioned
+ on a device. This number may be increased in the future.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.auth.account/account_manager.fidl#15">MAX_PERSONAE_PER_ACCOUNT</a></td>
@@ -1185,6 +1186,9 @@
                     <code>128</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The maximum number of personae that may be simultaneously defined within a
+ Fuchsia account. This number may be increased in the future.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.auth.account/account_manager.fidl#19">MAX_ID_SIZE</a></td>
@@ -1192,6 +1196,9 @@
                     <code>256</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The maximum length of the global Fuchsia account and persona identifiers,
+ in bytes.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.auth.account/account_manager.fidl#22">MAX_NAME_SIZE</a></td>
@@ -1199,6 +1206,8 @@
                     <code>128</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The maximum length of the (UTF-8 encoded) human readable names, in bytes.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.bluetooth.bredr/index.md b/sdk/fidl/fuchsia.bluetooth.bredr/index.md
index e511d37..46c0baa 100644
--- a/sdk/fidl/fuchsia.bluetooth.bredr/index.md
+++ b/sdk/fidl/fuchsia.bluetooth.bredr/index.md
@@ -761,15 +761,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#59">kPSM_SDP</a></td>
             <td>
                     <code>1</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#60">kPSM_RFCOMM</a></td>
@@ -777,6 +776,7 @@
                     <code>3</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#61">kPSM_TCSBIN</a></td>
@@ -784,6 +784,7 @@
                     <code>5</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#62">kPSM_TCSBINCordless</a></td>
@@ -791,6 +792,7 @@
                     <code>7</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#63">kPSM_BNEP</a></td>
@@ -798,6 +800,7 @@
                     <code>15</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#64">kPSM_HIDControl</a></td>
@@ -805,6 +808,7 @@
                     <code>17</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#65">kPSM_HIDInterrupt</a></td>
@@ -812,6 +816,7 @@
                     <code>19</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#66">kPSM_AVCTP</a></td>
@@ -819,6 +824,7 @@
                     <code>23</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#67">kPSM_AVDTP</a></td>
@@ -826,6 +832,7 @@
                     <code>25</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#68">kPSM_AVCTP_Browse</a></td>
@@ -833,6 +840,7 @@
                     <code>27</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#69">kPSM_ATT</a></td>
@@ -840,6 +848,7 @@
                     <code>31</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#70">kPSM_3DSP</a></td>
@@ -847,6 +856,7 @@
                     <code>33</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#71">kPSM_LE_IPSP</a></td>
@@ -854,6 +864,7 @@
                     <code>35</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#72">kPSM_OTS</a></td>
@@ -861,6 +872,7 @@
                     <code>37</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#168">ATTR_SERVICE_RECORD_HANDLE</a></td>
@@ -868,6 +880,7 @@
                     <code>0</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#169">ATTR_SERVICE_CLASS_ID_LIST</a></td>
@@ -875,6 +888,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#170">ATTR_SERVICE_RECORD_STATE</a></td>
@@ -882,6 +896,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#171">ATTR_SERVICE_ID</a></td>
@@ -889,6 +904,7 @@
                     <code>3</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#172">ATTR_PROTOCOL_DESCRIPTOR_LIST</a></td>
@@ -896,6 +912,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#173">ATTR_ADDITIONAL_PROTOCOL_DESCRIPTOR_LIST</a></td>
@@ -903,6 +920,7 @@
                     <code>13</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#174">ATTR_BROWSE_GROUP_LIST</a></td>
@@ -910,6 +928,7 @@
                     <code>5</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#175">ATTR_LANGUAGE_BASE_ATTRIBUTE_ID_LIST</a></td>
@@ -917,6 +936,7 @@
                     <code>6</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#176">ATTR_SERVICE_INFO_TIME_TO_LIVE</a></td>
@@ -924,6 +944,7 @@
                     <code>7</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#177">ATTR_SERVICE_AVAILABILITY</a></td>
@@ -931,6 +952,7 @@
                     <code>8</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.bredr/service.fidl#178">ATTR_BLUETOOTH_PROFILE_DESCRIPTOR_LIST</a></td>
@@ -938,6 +960,7 @@
                     <code>9</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.bluetooth.gatt/index.md b/sdk/fidl/fuchsia.bluetooth.gatt/index.md
index 6e634c2..c7a1969 100644
--- a/sdk/fidl/fuchsia.bluetooth.gatt/index.md
+++ b/sdk/fidl/fuchsia.bluetooth.gatt/index.md
@@ -861,15 +861,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/constants.fidl#7">MAX_VALUE_LENGTH</a></td>
             <td>
                     <code>512</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/types.fidl#65">kPropertyBroadcast</a></td>
@@ -877,6 +876,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/types.fidl#66">kPropertyRead</a></td>
@@ -884,6 +884,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/types.fidl#67">kPropertyWriteWithoutResponse</a></td>
@@ -891,6 +892,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/types.fidl#68">kPropertyWrite</a></td>
@@ -898,6 +900,7 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/types.fidl#69">kPropertyNotify</a></td>
@@ -905,6 +908,7 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/types.fidl#70">kPropertyIndicate</a></td>
@@ -912,6 +916,7 @@
                     <code>32</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/types.fidl#71">kPropertyAuthenticatedSignedWrites</a></td>
@@ -919,6 +924,7 @@
                     <code>64</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/types.fidl#72">kPropertyReliableWrite</a></td>
@@ -926,6 +932,7 @@
                     <code>256</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.gatt/types.fidl#73">kPropertyWritableAuxiliaries</a></td>
@@ -933,6 +940,7 @@
                     <code>512</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.bluetooth.test/index.md b/sdk/fidl/fuchsia.bluetooth.test/index.md
index f3023a9..2ab46a3 100644
--- a/sdk/fidl/fuchsia.bluetooth.test/index.md
+++ b/sdk/fidl/fuchsia.bluetooth.test/index.md
@@ -861,15 +861,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.test/hci_emulator.fidl#9">MAX_LEGACY_ADVERTISING_DATA_LENGTH</a></td>
             <td>
                     <code>31</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.bluetooth.test/hci_emulator.fidl#10">MAX_EXTENDED_ADVERTISING_DATA_LENGTH</a></td>
@@ -877,6 +876,7 @@
                     <code>251</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.camera.common/index.md b/sdk/fidl/fuchsia.camera.common/index.md
index 116f5cb..86c44cf 100644
--- a/sdk/fidl/fuchsia.camera.common/index.md
+++ b/sdk/fidl/fuchsia.camera.common/index.md
@@ -395,15 +395,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-camera-common/common.fidl#13">CAMERA_OUTPUT_UNKNOWN</a></td>
             <td>
                     <code>0</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-camera-common/common.fidl#14">CAMERA_OUTPUT_STILL_IMAGE</a></td>
@@ -411,6 +410,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-camera-common/common.fidl#15">CAMERA_OUTPUT_BURST</a></td>
@@ -418,6 +418,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-camera-common/common.fidl#16">CAMERA_OUTPUT_STREAM</a></td>
@@ -425,6 +426,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-camera-common/common.fidl#17">CAMERA_OUTPUT_HDR</a></td>
@@ -432,6 +434,7 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-camera-common/common.fidl#18">CAMERA_OUTPUT_DEPTH</a></td>
@@ -439,6 +442,7 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-camera-common/common.fidl#19">CAMERA_OUTPUT_STEREO</a></td>
@@ -446,6 +450,7 @@
                     <code>32</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.camera/index.md b/sdk/fidl/fuchsia.camera/index.md
index 6ee20e4..e90ac6d 100644
--- a/sdk/fidl/fuchsia.camera/index.md
+++ b/sdk/fidl/fuchsia.camera/index.md
@@ -586,15 +586,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.camera/camera.fidl#13">MAX_FORMATS_PER_RESPONSE</a></td>
             <td>
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.camera/camera.fidl#18">CAMERA_OUTPUT_UNKNOWN</a></td>
@@ -602,6 +601,10 @@
                     <code>0</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> A coarse set of capabilities.  This struct is used in the camera description
+ to help filter out cameras which will not have the needed capabilities.
+ This set of declarations would be the bitfield: CameraOutputCapabilities.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.camera/camera.fidl#19">CAMERA_OUTPUT_STILL_IMAGE</a></td>
@@ -609,6 +612,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.camera/camera.fidl#20">CAMERA_OUTPUT_BURST</a></td>
@@ -616,6 +620,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.camera/camera.fidl#21">CAMERA_OUTPUT_STREAM</a></td>
@@ -623,6 +628,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.camera/camera.fidl#22">CAMERA_OUTPUT_HDR</a></td>
@@ -630,6 +636,7 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.camera/camera.fidl#23">CAMERA_OUTPUT_DEPTH</a></td>
@@ -637,6 +644,7 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.camera/camera.fidl#24">CAMERA_OUTPUT_STEREO</a></td>
@@ -644,6 +652,7 @@
                     <code>32</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.cobalt/index.md b/sdk/fidl/fuchsia.cobalt/index.md
index 1f9b387..9e64b24 100644
--- a/sdk/fidl/fuchsia.cobalt/index.md
+++ b/sdk/fidl/fuchsia.cobalt/index.md
@@ -1731,15 +1731,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-cobalt/cobalt.fidl#41">MAX_BYTES_PER_EVENT</a></td>
             <td>
                     <code>102400</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.debugdata/index.md b/sdk/fidl/fuchsia.debugdata/index.md
index 8be91f8..b289468 100644
--- a/sdk/fidl/fuchsia.debugdata/index.md
+++ b/sdk/fidl/fuchsia.debugdata/index.md
@@ -82,15 +82,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-debugdata/debugdata.fidl#8">MAX_NAME</a></td>
             <td>
                     <code>1024</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> The maximum length, in bytes, of data sink or configuration name.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.device.manager/index.md b/sdk/fidl/fuchsia.device.manager/index.md
index 536c7b1..9e50be4 100644
--- a/sdk/fidl/fuchsia.device.manager/index.md
+++ b/sdk/fidl/fuchsia.device.manager/index.md
@@ -1570,15 +1570,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/administrator.fidl#10">SUSPEND_FLAG_REBOOT</a></td>
             <td>
                     <code>3705405696</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Check the DDK for all available flags.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/administrator.fidl#11">SUSPEND_FLAG_POWEROFF</a></td>
@@ -1586,6 +1586,7 @@
                     <code>3705405952</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/coordinator.fidl#31">DEVICE_NAME_MAX</a></td>
@@ -1593,6 +1594,8 @@
                     <code>31</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> This definition must match `ZX_DEVICE_NAME_MAX` and is checked by a static assert.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/coordinator.fidl#35">DEVICE_PATH_MAX</a></td>
@@ -1600,6 +1603,8 @@
                     <code>1024</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum number of bytes in a path
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/coordinator.fidl#38">DEVICE_ARGS_MAX</a></td>
@@ -1607,6 +1612,8 @@
                     <code>1024</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum number of bytes in a device arguments string.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/coordinator.fidl#41">METADATA_MAX</a></td>
@@ -1614,6 +1621,8 @@
                     <code>8192</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum number of bytes in a metadata payload
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/coordinator.fidl#44">PROPERTIES_MAX</a></td>
@@ -1621,6 +1630,8 @@
                     <code>256</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum number of properties that can be attached to a device
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/coordinator.fidl#47">COMPONENTS_MAX</a></td>
@@ -1628,6 +1639,8 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum number of components that a composite device can have
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/coordinator.fidl#50">DEVICE_COMPONENT_PARTS_MAX</a></td>
@@ -1635,6 +1648,8 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum number of parts that a composite device component can have
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-manager/coordinator.fidl#53">DEVICE_COMPONENT_PART_INSTRUCTIONS_MAX</a></td>
@@ -1642,6 +1657,8 @@
                     <code>32</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum instructions in a match program
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.device.test/index.md b/sdk/fidl/fuchsia.device.test/index.md
index 89eda21..4567226 100644
--- a/sdk/fidl/fuchsia.device.test/index.md
+++ b/sdk/fidl/fuchsia.device.test/index.md
@@ -204,13 +204,13 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-test/test.fidl#10">CONTROL_DEVICE</a></td>
             <td><code>/dev/test/test</code></td>
                     <td><code>String</code></td>
+            <td> The path which can be used to open the control device
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-test/test.fidl#46">MAX_DEVICE_NAME_LEN</a></td>
@@ -218,6 +218,8 @@
                     <code>31</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum device name len.  This value must match `ZX_DEVICE_NAME_MAX`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device-test/test.fidl#49">MAX_DEVICE_PATH_LEN</a></td>
@@ -225,6 +227,8 @@
                     <code>1024</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum device path len
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.device/index.md b/sdk/fidl/fuchsia.device/index.md
index 8052d0e..b77b29f 100644
--- a/sdk/fidl/fuchsia.device/index.md
+++ b/sdk/fidl/fuchsia.device/index.md
@@ -359,15 +359,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/controller.fidl#10">MAX_DEVICE_NAME_LEN</a></td>
             <td>
                     <code>32</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> Maxmium length for a device name
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/controller.fidl#12">MAX_DEVICE_PATH_LEN</a></td>
@@ -375,6 +375,8 @@
                     <code>1024</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> Maximum length of a device path
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/controller.fidl#14">MAX_DRIVER_NAME_LEN</a></td>
@@ -382,6 +384,8 @@
                     <code>32</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> Maxmium length for a driver name
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/controller.fidl#16">MAX_DRIVER_PATH_LEN</a></td>
@@ -389,6 +393,8 @@
                     <code>1024</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> Maximum length for a driver path
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/controller.fidl#20">DEVICE_SIGNAL_READABLE</a></td>
@@ -396,6 +402,9 @@
                     <code>16777216</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Signal that will be active on a device event handle if the device's read() method
+ will return data.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/controller.fidl#24">DEVICE_SIGNAL_OOB</a></td>
@@ -403,6 +412,10 @@
                     <code>33554432</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Signal that will be active on a device event handle if the device has some out-of-band
+ mechanism that needs attention.
+ This is primarily used by the PTY support.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/controller.fidl#27">DEVICE_SIGNAL_WRITABLE</a></td>
@@ -410,6 +423,9 @@
                     <code>67108864</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Signal that will be active on a device event handle if the device's write() method
+ will accept data.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/controller.fidl#30">DEVICE_SIGNAL_ERROR</a></td>
@@ -417,6 +433,9 @@
                     <code>134217728</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Signal that will be active on a device event handle if the device has encountered an error.
+ This is primarily used by the PTY support.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/controller.fidl#33">DEVICE_SIGNAL_HANGUP</a></td>
@@ -424,11 +443,15 @@
                     <code>268435456</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Signal that will be active on a device event handle if the device has been disconnected.
+ This is primarily used by the PTY support.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-device/name-provider.fidl#9">DEFAULT_DEVICE_NAME</a></td>
             <td><code>fuchsia</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.gpu.magma/index.md b/sdk/fidl/fuchsia.gpu.magma/index.md
index b465d21..fc6a0fd 100644
--- a/sdk/fidl/fuchsia.gpu.magma/index.md
+++ b/sdk/fidl/fuchsia.gpu.magma/index.md
@@ -495,15 +495,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.gpu.magma/magma.fidl#28">kReceiveBufferSize</a></td>
             <td>
                     <code>2048</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Primary declarations.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.hardware.block/index.md b/sdk/fidl/fuchsia.hardware.block/index.md
index c891c60..47584b0 100644
--- a/sdk/fidl/fuchsia.hardware.block/index.md
+++ b/sdk/fidl/fuchsia.hardware.block/index.md
@@ -312,15 +312,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-block/block.fidl#10">FLAG_READONLY</a></td>
             <td>
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-block/block.fidl#13">FLAG_REMOVABLE</a></td>
@@ -328,6 +327,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-block/block.fidl#16">FLAG_BOOTPART</a></td>
@@ -335,6 +335,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-block/block.fidl#20">MAX_TRANSFER_UNBOUNDED</a></td>
@@ -342,6 +343,7 @@
                     <code>4294967295</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-block/block.fidl#72">VMOID_INVALID</a></td>
@@ -349,6 +351,7 @@
                     <code>0</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.hardware.display/index.md b/sdk/fidl/fuchsia.hardware.display/index.md
index 559632c..652854d 100644
--- a/sdk/fidl/fuchsia.hardware.display/index.md
+++ b/sdk/fidl/fuchsia.hardware.display/index.md
@@ -1455,15 +1455,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-display/display-controller.fidl#11">invalidId</a></td>
             <td>
                     <code>0</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-display/display-controller.fidl#34">modeInterlaced</a></td>
@@ -1471,6 +1470,7 @@
                     <code>1</code>
                 </td>
                 <td><code>int32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-display/display-controller.fidl#45">identifierMaxLen</a></td>
@@ -1478,6 +1478,7 @@
                     <code>128</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-display/display-controller.fidl#94">typeSimple</a></td>
@@ -1485,6 +1486,7 @@
                     <code>0</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.hardware.ethernet/index.md b/sdk/fidl/fuchsia.hardware.ethernet/index.md
index 113c5e4..e9c5ab3 100644
--- a/sdk/fidl/fuchsia.hardware.ethernet/index.md
+++ b/sdk/fidl/fuchsia.hardware.ethernet/index.md
@@ -449,15 +449,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-ethernet/ethernet.fidl#14">INFO_FEATURE_WLAN</a></td>
             <td>
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-ethernet/ethernet.fidl#15">INFO_FEATURE_SYNTH</a></td>
@@ -465,6 +464,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-ethernet/ethernet.fidl#16">INFO_FEATURE_LOOPBACK</a></td>
@@ -472,6 +472,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-ethernet/ethernet.fidl#37">SIGNAL_STATUS</a></td>
@@ -479,6 +480,7 @@
                     <code>16777216</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-ethernet/ethernet.fidl#40">DEVICE_STATUS_ONLINE</a></td>
@@ -486,6 +488,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-ethernet/ethernet.fidl#43">MAX_CLIENT_NAME_LEN</a></td>
@@ -493,6 +496,7 @@
                     <code>15</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-ethernet/ethernet.fidl#47">SET_CLIENT_NAME_MAX_LEN</a></td>
@@ -500,6 +504,7 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.hardware.pty/index.md b/sdk/fidl/fuchsia.hardware.pty/index.md
index ba2fa6b..3cffb91 100644
--- a/sdk/fidl/fuchsia.hardware.pty/index.md
+++ b/sdk/fidl/fuchsia.hardware.pty/index.md
@@ -780,24 +780,16 @@
 
 ## **CONSTANTS**
 
- A PTY (pseudoterminal) emulates terminal devices, with a "server" side
- (which represents the keyboard+monitor side of the terminal and is obtained
- by opening /dev/misc/ptmx) and a number of "client" sides which are obtained
- by calling `OpenClient`.
-
- Client PTYs are identified by the `id` used in the `OpenClient` call. The
- first Client PTY *must* be 0, and it is the only Client PTY that is allowed
- to create additional Client PTYs, receive Events, etc. It is the
- Controlling PTY.
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-pty/pty.fidl#21">FEATURE_RAW</a></td>
             <td>
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> When Feature Raw is enabled, OOB Events like ^c, ^z, etc are not generated.
+ Instead the character is read from the read() input path.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-pty/pty.fidl#29">EVENT_HANGUP</a></td>
@@ -805,6 +797,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The terminal has no active client.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-pty/pty.fidl#31">EVENT_INTERRUPT</a></td>
@@ -812,6 +806,8 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The terminal received a ^C control character.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-pty/pty.fidl#33">EVENT_SUSPEND</a></td>
@@ -819,6 +815,8 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The terminal received a ^Z control character.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-pty/pty.fidl#35">EVENT_MASK</a></td>
@@ -826,6 +824,8 @@
                     <code>7</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> All events
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-hardware-pty/pty.fidl#38">SIGNAL_EVENT</a></td>
@@ -833,6 +833,8 @@
                     <code>33554432</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> When an event is pending, this signal is asserted on the Controlling PTY.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.io/index.md b/sdk/fidl/fuchsia.io/index.md
index edb8127..eef2b26 100644
--- a/sdk/fidl/fuchsia.io/index.md
+++ b/sdk/fidl/fuchsia.io/index.md
@@ -2613,15 +2613,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#31">FILE_SIGNAL_READABLE</a></td>
             <td>
                     <code>16777216</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates the file is ready for reading.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#33">FILE_SIGNAL_WRITABLE</a></td>
@@ -2629,6 +2629,8 @@
                     <code>33554432</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates the file is ready for writing.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#74">DEVICE_SIGNAL_READABLE</a></td>
@@ -2636,34 +2638,44 @@
                     <code>16777216</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates the device is ready for reading.
+</td>
         </tr>
     <tr>
-            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#76">DEVICE_SIGNAL_WRITABLE</a></td>
+            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#76">DEVICE_SIGNAL_OOB</a></td>
             <td>
                     <code>33554432</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates an out-of-band state transition has occurred.
+</td>
         </tr>
     <tr>
-            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#78">DEVICE_SIGNAL_ERROR</a></td>
+            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#78">DEVICE_SIGNAL_WRITABLE</a></td>
             <td>
                     <code>67108864</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates the device is ready for writing.
+</td>
         </tr>
     <tr>
-            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#80">DEVICE_SIGNAL_HANGUP</a></td>
+            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#80">DEVICE_SIGNAL_ERROR</a></td>
             <td>
                     <code>134217728</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates the device has encountered an error state.
+</td>
         </tr>
     <tr>
-            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#82">DEVICE_SIGNAL_OOB</a></td>
+            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#82">DEVICE_SIGNAL_HANGUP</a></td>
             <td>
                     <code>268435456</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates the device has hung up on the current connection.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#98">OPEN_RIGHT_READABLE</a></td>
@@ -2671,6 +2683,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Can read from target object.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#100">OPEN_RIGHT_WRITABLE</a></td>
@@ -2678,6 +2692,8 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Can write to target object.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#102">OPEN_RIGHT_ADMIN</a></td>
@@ -2685,6 +2701,8 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Connection can mount/umount filesystem.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#105">OPEN_FLAG_CREATE</a></td>
@@ -2692,6 +2710,8 @@
                     <code>65536</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Create the object if it doesn't exist.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#107">OPEN_FLAG_CREATE_IF_ABSENT</a></td>
@@ -2699,6 +2719,8 @@
                     <code>131072</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> (with Create) Fail if the object already exists.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#109">OPEN_FLAG_TRUNCATE</a></td>
@@ -2706,6 +2728,8 @@
                     <code>262144</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Truncate the object before usage.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#112">OPEN_FLAG_DIRECTORY</a></td>
@@ -2713,6 +2737,9 @@
                     <code>524288</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Assert that the object to be opened is a directory.
+ Return an error if the target object is not a directory.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#114">OPEN_FLAG_APPEND</a></td>
@@ -2720,6 +2747,8 @@
                     <code>1048576</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Seek to the end of the object before all writes.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#116">OPEN_FLAG_NO_REMOTE</a></td>
@@ -2727,6 +2756,8 @@
                     <code>2097152</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> If the object is a mount point, open the local directory.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#127">OPEN_FLAG_NODE_REFERENCE</a></td>
@@ -2734,6 +2765,17 @@
                     <code>4194304</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Open a reference to the object, not the object itself.
+ It is ONLY valid to pass the following flags together with `OPEN_FLAG_NODE_REFERENCE`:
+ - `OPEN_FLAG_DIRECTORY`
+ - `OPEN_FLAG_NOT_DIRECTORY`
+ - `OPEN_FLAG_DESCRIBE`
+ otherwise an error is returned.
+ If an object is opened or cloned using this method, the resulting connection does not carry
+ any permission flags.
+ The resulting node allows a limited set of operations: `GetAttr`, `Clone`, `Close`, `Describe`,
+ and, if the node is a file, these extra operations: `GetFlags`, `SetFlags`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#130">OPEN_FLAGS_ALLOWED_WITH_NODE_REFERENCE</a></td>
@@ -2741,6 +2783,9 @@
                     <code>46661632</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Binary OR of `OPEN_FLAG_DIRECTORY`, OPEN_FLAG_NOT_DIRECTORY, OPEN_FLAG_DESCRIBE, and
+ `OPEN_FLAG_NODE_REFERENCE`. Flags used when opening a node reference must fall within this mask.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#133">OPEN_FLAG_DESCRIBE</a></td>
@@ -2748,6 +2793,9 @@
                     <code>8388608</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Requests that an "OnOpen" event is sent to the interface request.
+ The event will contain a non-null NodeInfo if the open/clone is successful.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#150">OPEN_FLAG_POSIX</a></td>
@@ -2755,6 +2803,23 @@
                     <code>16777216</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Specify this flag to request POSIX-compatibility. Currently, it affects permission handling.
+ During Open:
+ - If the target path is a directory, the rights on the new connection expands to include
+   `OPEN_RIGHT_WRITABLE` if and only if the current connection and all intermediate mount points
+   are writable.
+ - Otherwise, this flag is ignored. It is an access denied error to request more rights
+   than those on the current connection, or any intermediate mount points.
+
+ If the posix compatibility flag is not specified, opening always uses the requested rights,
+ failing the operation with access denied error if requested rights exceeds the rights attached
+ to the current connection.
+
+ If the requesting connection is read-only and the requested rights are read-only, the flag
+ may be ignored by the server, and is not forwarded downstream. This is an implementation detail,
+ necessary to enforce hierarchical permissions across mount points, and should have no effect
+ on the expected behavior for clients.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#153">OPEN_FLAG_NOT_DIRECTORY</a></td>
@@ -2762,6 +2827,9 @@
                     <code>33554432</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Assert that the object to be opened is not a directory.
+ Return an error if the target object is a directory.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#157">CLONE_FLAG_SAME_RIGHTS</a></td>
@@ -2769,6 +2837,10 @@
                     <code>67108864</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> When used during clone, the new connection inherits the rights on the source connection,
+ regardless if it is a file or directory. Otherwise, clone attempts to use the requested rights.
+ It is invalid to pass any of the `OPEN_RIGHT_*` flags together with `CLONE_FLAG_SAME_RIGHTS`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#224">MODE_PROTECTION_MASK</a></td>
@@ -2776,6 +2848,11 @@
                     <code>4095</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Bits reserved for posix protections. Native fuchsia filesystems
+ are not required to set bits contained within `MODE_PROTECTION_MASK`,
+ but filesystems that wish to do so may refer to sys/stat.h for their
+ definitions.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#228">MODE_TYPE_MASK</a></td>
@@ -2783,6 +2860,10 @@
                     <code>1044480</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Bits indicating node type. The canonical mechanism to check
+ for a node type is to take 'mode', bitwise AND it with the
+ `MODE_TYPE_MASK`, and check exact equality against a mode type.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#229">MODE_TYPE_DIRECTORY</a></td>
@@ -2790,6 +2871,7 @@
                     <code>16384</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#230">MODE_TYPE_BLOCK_DEVICE</a></td>
@@ -2797,6 +2879,7 @@
                     <code>24576</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#231">MODE_TYPE_FILE</a></td>
@@ -2804,6 +2887,7 @@
                     <code>32768</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#232">MODE_TYPE_SOCKET</a></td>
@@ -2811,6 +2895,7 @@
                     <code>49152</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#233">MODE_TYPE_SERVICE</a></td>
@@ -2818,6 +2903,7 @@
                     <code>65536</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#253">MAX_IOCTL_HANDLES</a></td>
@@ -2825,6 +2911,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#257">MAX_BUF</a></td>
@@ -2832,6 +2919,9 @@
                     <code>8192</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> The maximal buffer size which can be transmitted for buffered operations.
+ This capacity is currently set somewhat arbitrarily.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#261">MAX_PATH</a></td>
@@ -2839,6 +2929,8 @@
                     <code>4096</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> The maximum length, in bytes, of a filesystem string.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#263">MAX_FILENAME</a></td>
@@ -2846,6 +2938,8 @@
                     <code>255</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> The maximum length, in bytes, of a single filesystem component.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#267">NODE_ATTRIBUTE_FLAG_CREATION_TIME</a></td>
@@ -2853,6 +2947,9 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The fields of 'attributes' which are used to update the Node are indicated
+ by the 'flags' argument.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#268">NODE_ATTRIBUTE_FLAG_MODIFICATION_TIME</a></td>
@@ -2860,6 +2957,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#281">VMO_FLAG_READ</a></td>
@@ -2867,6 +2965,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Requests that the VMO be readable.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#284">VMO_FLAG_WRITE</a></td>
@@ -2874,6 +2974,8 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Requests that the VMO be writable.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#287">VMO_FLAG_EXEC</a></td>
@@ -2881,6 +2983,8 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Requests that the VMO be executable.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#292">VMO_FLAG_PRIVATE</a></td>
@@ -2888,6 +2992,10 @@
                     <code>65536</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Require a copy-on-write clone of the underlying VMO.
+ The request should fail if the VMO is not cloned.
+ May not be supplied with fuchsia_io_`VMO_FLAG_EXACT`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#297">VMO_FLAG_EXACT</a></td>
@@ -2895,6 +3003,10 @@
                     <code>131072</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Require an exact (non-cloned) handle to the underlying VMO.
+ The request should fail if a handle to the exact VMO is not returned.
+ May not be supplied with `VMO_FLAG_PRIVATE`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#366">DIRENT_TYPE_UNKNOWN</a></td>
@@ -2902,6 +3014,8 @@
                     <code>0</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> A dirent with an unknown type.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#368">DIRENT_TYPE_DIRECTORY</a></td>
@@ -2909,6 +3023,8 @@
                     <code>4</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> A dirent representing a directory object.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#370">DIRENT_TYPE_BLOCK_DEVICE</a></td>
@@ -2916,6 +3032,8 @@
                     <code>6</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> A dirent representing a block device object.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#372">DIRENT_TYPE_FILE</a></td>
@@ -2923,6 +3041,8 @@
                     <code>8</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> A dirent representing a file object.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#374">DIRENT_TYPE_SOCKET</a></td>
@@ -2930,6 +3050,8 @@
                     <code>12</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> A dirent representing a socket object.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#376">DIRENT_TYPE_SERVICE</a></td>
@@ -2937,6 +3059,8 @@
                     <code>16</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> A dirent representing a service object.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#380">INO_UNKNOWN</a></td>
@@ -2944,6 +3068,9 @@
                     <code>18446744073709551615</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> Nodes which do not have ino values should return this value
+ from Readdir and GetAttr.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#383">WATCH_EVENT_DELETED</a></td>
@@ -2951,6 +3078,8 @@
                     <code>0</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> Indicates the directory being watched has been deleted.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#385">WATCH_EVENT_ADDED</a></td>
@@ -2958,6 +3087,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> Indicates a node has been created (either new or moved) into a directory.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#387">WATCH_EVENT_REMOVED</a></td>
@@ -2965,6 +3096,8 @@
                     <code>2</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> Identifies a node has been removed (either deleted or moved) from the directory.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#389">WATCH_EVENT_EXISTING</a></td>
@@ -2972,6 +3105,8 @@
                     <code>3</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> Identifies a node already existed in the directory when watching started.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#391">WATCH_EVENT_IDLE</a></td>
@@ -2979,6 +3114,8 @@
                     <code>4</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td> Identifies that no more `WATCH_EVENT_EXISTING` events will be sent.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#394">WATCH_MASK_DELETED</a></td>
@@ -2986,6 +3123,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Used by Directory::Watch. Requests transmission of `WATCH_EVENT_DELETED`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#396">WATCH_MASK_ADDED</a></td>
@@ -2993,6 +3132,8 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Used by Directory::Watch. Requests transmission of `WATCH_EVENT_ADDED`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#398">WATCH_MASK_REMOVED</a></td>
@@ -3000,6 +3141,8 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Used by Directory::Watch. Requests transmission of `WATCH_EVENT_REMOVED`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#400">WATCH_MASK_EXISTING</a></td>
@@ -3007,6 +3150,8 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Used by Directory::Watch. Requests transmission of `WATCH_EVENT_EXISTING`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#402">WATCH_MASK_IDLE</a></td>
@@ -3014,6 +3159,8 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Used by Directory::Watch. Requests transmission of `WATCH_EVENT_IDLE`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#404">WATCH_MASK_ALL</a></td>
@@ -3021,6 +3168,8 @@
                     <code>31</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Used by Directory::Watch. Requests transmission of all watcher events.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#564">MOUNT_CREATE_FLAG_REPLACE</a></td>
@@ -3028,6 +3177,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-io/io.fidl#566">MAX_FS_NAME_BUFFER</a></td>
@@ -3035,6 +3185,7 @@
                     <code>32</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.kernel/index.md b/sdk/fidl/fuchsia.kernel/index.md
index 8a28c55..f8192e9 100644
--- a/sdk/fidl/fuchsia.kernel/index.md
+++ b/sdk/fidl/fuchsia.kernel/index.md
@@ -158,15 +158,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-kernel/kernel-debug.fidl#10">DEBUG_COMMAND_MAX</a></td>
             <td>
                     <code>1024</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum number of bytes in a command string
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.ledger/index.md b/sdk/fidl/fuchsia.ledger/index.md
index 2acb5b4..77c825c 100644
--- a/sdk/fidl/fuchsia.ledger/index.md
+++ b/sdk/fidl/fuchsia.ledger/index.md
@@ -1817,15 +1817,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ledger/ledger.fidl#14">NO_LINT</a></td>
             <td>
                     <code>65536</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ledger/ledger.fidl#20">PAGE_ID_SIZE</a></td>
@@ -1833,6 +1832,8 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Size in bytes of Page IDs.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.logger/index.md b/sdk/fidl/fuchsia.logger/index.md
index ddc1817..e5c0175 100644
--- a/sdk/fidl/fuchsia.logger/index.md
+++ b/sdk/fidl/fuchsia.logger/index.md
@@ -283,15 +283,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-logger/logger.fidl#18">MAX_TAGS</a></td>
             <td>
                     <code>5</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-logger/logger.fidl#21">MAX_TAG_LEN_BYTES</a></td>
@@ -299,6 +298,7 @@
                     <code>63</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-logger/logger.fidl#45">MAX_TAGS_PER_LOG_MESSAGE</a></td>
@@ -306,6 +306,7 @@
                     <code>5</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-logger/logger.fidl#83">MAX_LOG_MANY_SIZE_BYTES</a></td>
@@ -313,6 +314,7 @@
                     <code>16384</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.media.audio/index.md b/sdk/fidl/fuchsia.media.audio/index.md
index 71cb2aa..dd5239f 100644
--- a/sdk/fidl/fuchsia.media.audio/index.md
+++ b/sdk/fidl/fuchsia.media.audio/index.md
@@ -163,15 +163,16 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media.audio/gain_control.fidl#76">MUTED_GAIN_DB</a></td>
             <td>
                     <code>-160</code>
                 </td>
                 <td><code>float32</code></td>
+            <td> Gain value producing silence. Gain values less than this value are permitted,
+ but produce the same effect as this value.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media.audio/gain_control.fidl#79">MAX_GAIN_DB</a></td>
@@ -179,6 +180,8 @@
                     <code>24</code>
                 </td>
                 <td><code>float32</code></td>
+            <td> Maximum permitted gain value.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.media.playback/index.md b/sdk/fidl/fuchsia.media.playback/index.md
index b0adab6..28ef907 100644
--- a/sdk/fidl/fuchsia.media.playback/index.md
+++ b/sdk/fidl/fuchsia.media.playback/index.md
@@ -924,38 +924,42 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media.playback/problem.fidl#25">PROBLEM_INTERNAL</a></td>
             <td><code>fuchsia.media.playback.Internal</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media.playback/problem.fidl#27">PROBLEM_ASSET_NOT_FOUND</a></td>
             <td><code>fuchsia.media.playback.AssetNotFound</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media.playback/problem.fidl#29">PROBLEM_CONTAINER_NOT_SUPPORTED</a></td>
             <td><code>fuchsia.media.playback.ContainerNotSupported</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media.playback/problem.fidl#31">PROBLEM_AUDIO_ENCODING_NOT_SUPPORTED</a></td>
             <td><code>fuchsia.media.playback.AudioEncodingNotSupported</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media.playback/problem.fidl#33">PROBLEM_VIDEO_ENCODING_NOT_SUPPORTED</a></td>
             <td><code>fuchsia.media.playback.VideoEncodingNotSupported</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media.playback/problem.fidl#35">PROBLEM_CONNECTION_FAILED</a></td>
             <td><code>fuchsia.media.playback.ConnectionFailed</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media.playback/seeking_reader.fidl#25">UNKNOWN_SIZE</a></td>
@@ -963,6 +967,9 @@
                     <code>18446744073709551615</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> Distinguished value for the `size` value returned by `SeekingReader.Describe`
+ Indicating that the size isn't known.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.media/index.md b/sdk/fidl/fuchsia.media/index.md
index acd8b72..5b30724 100644
--- a/sdk/fidl/fuchsia.media/index.md
+++ b/sdk/fidl/fuchsia.media/index.md
@@ -610,6 +610,7 @@
 
 ### CreateAudioRenderer {:#CreateAudioRenderer}
 
+ Create an AudioRenderer which outputs audio to the default device.
 
 #### Request
 <table>
@@ -625,6 +626,9 @@
 
 ### CreateAudioCapturer {:#CreateAudioCapturer}
 
+ Create an AudioCapturer which either captures from the current default
+ audio input device, or loops-back from the current default audio output
+ device based on value passed for the loopback flag.
 
 #### Request
 <table>
@@ -645,6 +649,19 @@
 
 ### SetSystemGain {:#SetSystemGain}
 
+ System Gain and Mute
+
+ Fuchsia clients control the volume of individual audio streams via the
+ fuchsia.media.audio.GainControl protocol. System Gain and Mute affect
+ all audio output, and are controlled with methods that use the same
+ concepts as GainControl, namely: independent gain and mute, with change
+ notifications. Setting System Mute to true leads to the same outcome as
+ setting System Gain to MUTED_GAIN_DB: all audio output across the system
+ is silenced.
+ Sets the systemwide gain in decibels. `gain_db` values are clamped to
+ the range -160 db to 0 db, inclusive. This setting is applied to all
+ audio output devices. Audio input devices are unaffected.
+ Does not affect System Mute.
 
 #### Request
 <table>
@@ -660,6 +677,9 @@
 
 ### SetSystemMute {:#SetSystemMute}
 
+ Sets/clears the systemwide 'Mute' state for audio output devices.
+ Audio input devices are unaffected. Changes to the System Mute state do
+ not affect the value of System Gain.
 
 #### Request
 <table>
@@ -675,6 +695,10 @@
 
 ### SystemGainMuteChanged {:#SystemGainMuteChanged}
 
+ Provides current values for systemwide Gain and Mute. When a client
+ connects to AudioCore, the system immediately sends that client a
+ SystemGainMuteChanged event with the current system Gain|Mute settings.
+ Subsequent events will be sent when these Gain|Mute values change.
 
 
 
@@ -725,6 +749,8 @@
 
 ### SetRenderUsageGain {:#SetRenderUsageGain}
 
+ Set the Usage gain applied to Renderers. By default, the gain for all
+ render usages is set to Unity (0 db).
 
 #### Request
 <table>
@@ -745,6 +771,8 @@
 
 ### SetCaptureUsageGain {:#SetCaptureUsageGain}
 
+ Set the Usage gain applied to Capturers. By default, the gain for all
+ capture usages is set to Unity (0 db).
 
 #### Request
 <table>
@@ -3278,9 +3306,12 @@
 ### AudioRenderUsage {:#AudioRenderUsage}
 Type: <code>uint32</code>
 
-*Defined in [fuchsia.media/audio_core.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#94)*
+*Defined in [fuchsia.media/audio_core.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#81)*
 
  Usage annotating the purpose of the stream being used to render audio.
+ An AudioRenderer's usage cannot be changed after creation.  The
+ AudioRenderUsage is used by audio policy to dictate how audio streams
+ interact with each other.
 
 
 <table>
@@ -3309,9 +3340,11 @@
 ### AudioCaptureUsage {:#AudioCaptureUsage}
 Type: <code>uint32</code>
 
-*Defined in [fuchsia.media/audio_core.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#119)*
+*Defined in [fuchsia.media/audio_core.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#108)*
 
- Usages annotating the purpose of the stream being used to capture audio.
+ Usages annotating the purpose of the stream being used to capture audio. The
+ AudioCaptureUsage is used by audio policy to dictate how audio streams
+ interact with each other.
 
 
 <table>
@@ -3336,7 +3369,7 @@
 ### AudioOutputRoutingPolicy {:#AudioOutputRoutingPolicy}
 Type: <code>uint32</code>
 
-*Defined in [fuchsia.media/audio_core.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#150)*
+*Defined in [fuchsia.media/audio_core.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#139)*
 
 
 
@@ -4437,7 +4470,7 @@
 ## **UNIONS**
 
 ### Usage {:#Usage}
-*Defined in [fuchsia.media/audio_core.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#143)*
+*Defined in [fuchsia.media/audio_core.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#132)*
 
 
 <table>
@@ -4756,15 +4789,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio.fidl#32">MIN_PCM_CHANNEL_COUNT</a></td>
             <td>
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Permitted ranges for AudioRenderer and AudioCapturer
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio.fidl#33">MAX_PCM_CHANNEL_COUNT</a></td>
@@ -4772,6 +4805,7 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio.fidl#34">MIN_PCM_FRAMES_PER_SECOND</a></td>
@@ -4779,6 +4813,7 @@
                     <code>1000</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio.fidl#35">MAX_PCM_FRAMES_PER_SECOND</a></td>
@@ -4786,20 +4821,23 @@
                     <code>192000</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
-            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#116">RENDER_USAGE_COUNT</a></td>
+            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#103">RENDER_USAGE_COUNT</a></td>
             <td>
                     <code>5</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     <tr>
-            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#141">CAPTURE_USAGE_COUNT</a></td>
+            <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_core.fidl#130">CAPTURE_USAGE_COUNT</a></td>
             <td>
                     <code>4</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_device_enumerator.fidl#7">AudioGainInfoFlag_Mute</a></td>
@@ -4807,6 +4845,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_device_enumerator.fidl#8">AudioGainInfoFlag_AgcSupported</a></td>
@@ -4814,6 +4853,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_device_enumerator.fidl#9">AudioGainInfoFlag_AgcEnabled</a></td>
@@ -4821,6 +4861,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_device_enumerator.fidl#29">SetAudioGainFlag_GainValid</a></td>
@@ -4828,6 +4869,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_device_enumerator.fidl#30">SetAudioGainFlag_MuteValid</a></td>
@@ -4835,6 +4877,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/audio_device_enumerator.fidl#31">SetAudioGainFlag_AgcValid</a></td>
@@ -4842,41 +4885,51 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/metadata.fidl#17">METADATA_LABEL_TITLE</a></td>
             <td><code>fuchsia.media.title</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/metadata.fidl#18">METADATA_LABEL_ARTIST</a></td>
             <td><code>fuchsia.media.artist</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/metadata.fidl#19">METADATA_LABEL_ALBUM</a></td>
             <td><code>fuchsia.media.album</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/metadata.fidl#20">METADATA_LABEL_PUBLISHER</a></td>
             <td><code>fuchsia.media.publisher</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/metadata.fidl#21">METADATA_LABEL_GENRE</a></td>
             <td><code>fuchsia.media.genre</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/metadata.fidl#22">METADATA_LABEL_COMPOSER</a></td>
             <td><code>fuchsia.media.composer</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/metadata.fidl#26">METADATA_SOURCE_TITLE</a></td>
             <td><code>fuchsia.media.source_title</code></td>
                     <td><code>String</code></td>
+            <td> The title of the source of the media, e.g. a player, streaming service, or
+ website.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream.fidl#154">NO_TIMESTAMP</a></td>
@@ -4884,6 +4937,10 @@
                     <code>9223372036854775807</code>
                 </td>
                 <td><code>int64</code></td>
+            <td> When used as a `StreamPacket.pts` value, indicates that the packet has no
+ specific presentation timestamp. The effective presentation time of such a
+ packet depends on the context in which the `StreamPacket` is used.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream.fidl#159">STREAM_PACKET_FLAG_KEY_FRAME</a></td>
@@ -4891,6 +4948,10 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates that the packet can be understood without reference to other
+ packets in the stream. This is typically used in compressed streams to
+ identify packets that contain key frames.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream.fidl#165">STREAM_PACKET_FLAG_DROPPABLE</a></td>
@@ -4898,6 +4959,11 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates that all other packets in the stream can be understood without
+ reference to this packet. This is typically used in compressed streams to
+ identify packets containing frames that may be discarded without affecting
+ other frames.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream.fidl#170">STREAM_PACKET_FLAG_DISCONTINUITY</a></td>
@@ -4905,6 +4971,10 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Indicates a discontinuity in an otherwise continuous-in-time sequence of
+ packets. The precise semantics of this flag depend on the context in which
+ the `StreamPacket` is used.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_common.fidl#9">KEY_ID_SIZE</a></td>
@@ -4912,6 +4982,7 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_common.fidl#10">MAX_INIT_VECTOR_SIZE</a></td>
@@ -4919,6 +4990,7 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_common.fidl#439">kMaxOobBytesSize</a></td>
@@ -4926,6 +4998,7 @@
                     <code>8192</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_processor.fidl#449">kDefaultInputPacketCountForClient</a></td>
@@ -4933,6 +5006,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_processor.fidl#451">kDefaultOutputPacketCountForClient</a></td>
@@ -4940,6 +5014,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_processor.fidl#458">kDefaultInputIsSingleBufferMode</a></td>
@@ -4947,6 +5022,7 @@
                     <code>false</code>
                 </td>
                 <td><code>bool</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_processor.fidl#459">kDefaultOutputIsSingleBufferMode</a></td>
@@ -4954,106 +5030,129 @@
                     <code>false</code>
                 </td>
                 <td><code>bool</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#39">AUDIO_ENCODING_AAC</a></td>
             <td><code>fuchsia.media.aac</code></td>
                     <td><code>String</code></td>
+            <td> Audio encodings.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#40">AUDIO_ENCODING_AMRNB</a></td>
             <td><code>fuchsia.media.amrnb</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#41">AUDIO_ENCODING_AMRWB</a></td>
             <td><code>fuchsia.media.amrwb</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#42">AUDIO_ENCODING_APTX</a></td>
             <td><code>fuchsia.media.aptx</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#43">AUDIO_ENCODING_FLAC</a></td>
             <td><code>fuchsia.media.flac</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#44">AUDIO_ENCODING_GSMMS</a></td>
             <td><code>fuchsia.media.gsmms</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#45">AUDIO_ENCODING_LPCM</a></td>
             <td><code>fuchsia.media.lpcm</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#46">AUDIO_ENCODING_MP3</a></td>
             <td><code>fuchsia.media.mp3</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#47">AUDIO_ENCODING_PCMALAW</a></td>
             <td><code>fuchsia.media.pcmalaw</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#48">AUDIO_ENCODING_PCMMULAW</a></td>
             <td><code>fuchsia.media.pcmmulaw</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#49">AUDIO_ENCODING_SBC</a></td>
             <td><code>fuchsia.media.sbc</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#50">AUDIO_ENCODING_VORBIS</a></td>
             <td><code>fuchsia.media.vorbis</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#53">VIDEO_ENCODING_H263</a></td>
             <td><code>fuchsia.media.h263</code></td>
                     <td><code>String</code></td>
+            <td> Video encodings.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#54">VIDEO_ENCODING_H264</a></td>
             <td><code>fuchsia.media.h264</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#55">VIDEO_ENCODING_MPEG4</a></td>
             <td><code>fuchsia.media.mpeg4</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#56">VIDEO_ENCODING_THEORA</a></td>
             <td><code>fuchsia.media.theora</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#57">VIDEO_ENCODING_UNCOMPRESSED</a></td>
             <td><code>fuchsia.media.uncompressed_video</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#58">VIDEO_ENCODING_VP3</a></td>
             <td><code>fuchsia.media.vp3</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#59">VIDEO_ENCODING_VP8</a></td>
             <td><code>fuchsia.media.vp8</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.media/stream_type.fidl#60">VIDEO_ENCODING_VP9</a></td>
             <td><code>fuchsia.media.vp9</code></td>
                     <td><code>String</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.modular/index.md b/sdk/fidl/fuchsia.modular/index.md
index a1c7e5e..c00419c 100644
--- a/sdk/fidl/fuchsia.modular/index.md
+++ b/sdk/fidl/fuchsia.modular/index.md
@@ -3023,6 +3023,31 @@
             </td>
         </tr></table>
 
+### GetInfo2 {:#GetInfo2}
+
+ For transition purposes only.
+
+#### Request
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    </table>
+
+
+#### Response
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    <tr>
+            <td><code>info</code></td>
+            <td>
+                <code><a class='link' href='#StoryInfo2'>StoryInfo2</a></code>
+            </td>
+        </tr><tr>
+            <td><code>state</code></td>
+            <td>
+                <code><a class='link' href='#StoryState'>StoryState</a></code>
+            </td>
+        </tr></table>
+
 ### RequestStart {:#RequestStart}
 
  Requests to run the story controlled by this `StoryController` instance.
@@ -3181,7 +3206,7 @@
 
 
 ## StoryWatcher {:#StoryWatcher}
-*Defined in [fuchsia.modular/story_controller.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/story/story_controller.fidl#57)*
+*Defined in [fuchsia.modular/story_controller.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/story/story_controller.fidl#61)*
 
  Implemented by the client calling StoryController.Watch().
 
@@ -3235,7 +3260,7 @@
 
 
 ## StoryLinksWatcher {:#StoryLinksWatcher}
-*Defined in [fuchsia.modular/story_controller.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/story/story_controller.fidl#73)*
+*Defined in [fuchsia.modular/story_controller.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/story/story_controller.fidl#77)*
 
  Implemented by the client calling StoryController.GetActiveLinks().
 
@@ -3307,6 +3332,31 @@
             </td>
         </tr></table>
 
+### GetStories2 {:#GetStories2}
+
+ For transition purposes only.
+
+#### Request
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    <tr>
+            <td><code>watcher</code></td>
+            <td>
+                <code><a class='link' href='#StoryProviderWatcher'>StoryProviderWatcher</a>?</code>
+            </td>
+        </tr></table>
+
+
+#### Response
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    <tr>
+            <td><code>story_infos</code></td>
+            <td>
+                <code>vector&lt;<a class='link' href='#StoryInfo2'>StoryInfo2</a>&gt;</code>
+            </td>
+        </tr></table>
+
 ### GetStoryInfo {:#GetStoryInfo}
 
  Requests detailed information about the given story. If the story doesn't
@@ -3333,6 +3383,31 @@
             </td>
         </tr></table>
 
+### GetStoryInfo2 {:#GetStoryInfo2}
+
+ For transition purposes only.
+
+#### Request
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    <tr>
+            <td><code>story_id</code></td>
+            <td>
+                <code>string</code>
+            </td>
+        </tr></table>
+
+
+#### Response
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    <tr>
+            <td><code>story_info</code></td>
+            <td>
+                <code><a class='link' href='#StoryInfo2'>StoryInfo2</a></code>
+            </td>
+        </tr></table>
+
 ### GetController {:#GetController}
 
  Obtains a controller for a previously created story identified by its story
@@ -3377,6 +3452,26 @@
             </td>
         </tr></table>
 
+### PreviousStories2 {:#PreviousStories2}
+
+ DEPRECATED: In favor of GetStories2(). For transition purposes only.
+
+#### Request
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    </table>
+
+
+#### Response
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    <tr>
+            <td><code>story_infos</code></td>
+            <td>
+                <code>vector&lt;<a class='link' href='#StoryInfo2'>StoryInfo2</a>&gt;</code>
+            </td>
+        </tr></table>
+
 ### Watch {:#Watch}
 
  Registers a watcher for changes in the story collection.
@@ -3413,7 +3508,7 @@
 
 
 ## StoryProviderWatcher {:#StoryProviderWatcher}
-*Defined in [fuchsia.modular/story_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/story/story_provider.fidl#44)*
+*Defined in [fuchsia.modular/story_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/story/story_provider.fidl#56)*
 
  Implemented by clients of StoryProvider.
 
@@ -3473,8 +3568,7 @@
 
 ### OnChange2 {:#OnChange2}
 
- This method *will not be called* but exists for transition purposes.
- Clients should implement a no-op stub.
+ For transition purposes only.
 
 #### Request
 <table>
@@ -3519,7 +3613,7 @@
 
 
 ## StoryActivityWatcher {:#StoryActivityWatcher}
-*Defined in [fuchsia.modular/story_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/story/story_provider.fidl#101)*
+*Defined in [fuchsia.modular/story_provider.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/story/story_provider.fidl#112)*
 
  Implemented by clients of StoryProvider in order to inform them about ongoing
  activities in stories. `activities` is the entire list of ongoing activities
@@ -7077,17 +7171,15 @@
 
 ## **CONSTANTS**
 
- This file contains the definition of Link as well as the structure
- of the data it holds.
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/annotation/annotation.fidl#19">MAX_ANNOTATION_KEY_LENGTH</a></td>
             <td>
                     <code>256</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum length of <a class='link' href='#AnnotationKey'>AnnotationKey</a>.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/annotation/annotation.fidl#23">MAX_ANNOTATION_VALUE_LENGTH</a></td>
@@ -7095,6 +7187,9 @@
                     <code>1024</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum length of <a class='link' href='#AnnotationValue'>AnnotationValue</a> fields:
+ `text` and `bytes`.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.modular/annotation/annotation.fidl#29">MAX_ANNOTATION_VALUE_BUFFER_LENGTH_BYTES</a></td>
@@ -7102,6 +7197,11 @@
                     <code>102400</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum length of the <a class='link' href='#AnnotationValue.buffer'>AnnotationValue.buffer</a> field, in
+ bytes.
+
+ Does not apply to other fields; see <a class='link' href='#MAX_ANNOTATION_VALUE_LENGTH'>MAX_ANNOTATION_VALUE_LENGTH</a>.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.net.mdns/index.md b/sdk/fidl/fuchsia.net.mdns/index.md
index 89ce08a..de3659b 100644
--- a/sdk/fidl/fuchsia.net.mdns/index.md
+++ b/sdk/fidl/fuchsia.net.mdns/index.md
@@ -494,15 +494,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.net.mdns/mdns.fidl#193">DEFAULT_SRV_PRIORITY</a></td>
             <td>
                     <code>0</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.net.mdns/mdns.fidl#194">DEFAULT_SRV_WEIGHT</a></td>
@@ -510,6 +509,7 @@
                     <code>0</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.net.mdns/mdns.fidl#195">DEFAULT_PTR_TTL</a></td>
@@ -517,6 +517,7 @@
                     <code>4500000000000</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.net.mdns/mdns.fidl#196">DEFAULT_SRV_TTL</a></td>
@@ -524,6 +525,7 @@
                     <code>120000000000</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.net.mdns/mdns.fidl#197">DEFAULT_TXT_TTL</a></td>
@@ -531,6 +533,7 @@
                     <code>4500000000000</code>
                 </td>
                 <td><code>int64</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.net/index.md b/sdk/fidl/fuchsia.net/index.md
index 3d60e04..22e5d78 100644
--- a/sdk/fidl/fuchsia.net/index.md
+++ b/sdk/fidl/fuchsia.net/index.md
@@ -621,15 +621,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-net/namelookup.fidl#38">MAX_HOSTNAME_SIZE</a></td>
             <td>
                     <code>255</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.netstack/index.md b/sdk/fidl/fuchsia.netstack/index.md
index 09a7307..66811c5 100644
--- a/sdk/fidl/fuchsia.netstack/index.md
+++ b/sdk/fidl/fuchsia.netstack/index.md
@@ -1035,15 +1035,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.netstack/netstack.fidl#96">NetInterfaceFlagUp</a></td>
             <td>
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Flags for NetInterface.flags.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.netstack/netstack.fidl#97">NetInterfaceFlagDhcp</a></td>
@@ -1051,6 +1051,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.perfmon.cpu/index.md b/sdk/fidl/fuchsia.perfmon.cpu/index.md
index a04aa81..c3079f9 100644
--- a/sdk/fidl/fuchsia.perfmon.cpu/index.md
+++ b/sdk/fidl/fuchsia.perfmon.cpu/index.md
@@ -564,15 +564,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-perfmon-cpu/perfmon.fidl#21">API_VERSION</a></td>
             <td>
                     <code>0</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-perfmon-cpu/perfmon.fidl#25">MAX_NUM_EVENTS</a></td>
@@ -580,6 +579,9 @@
                     <code>32</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td> The maximum number of events we support simultaneously.
+ Typically the h/w supports less than this, e.g., 7 or so.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.process/index.md b/sdk/fidl/fuchsia.process/index.md
index 8cedbbe..fe3a426 100644
--- a/sdk/fidl/fuchsia.process/index.md
+++ b/sdk/fidl/fuchsia.process/index.md
@@ -456,15 +456,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-process/resolver.fidl#11">MAX_RESOLVE_NAME_SIZE</a></td>
             <td>
                     <code>2048</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The maximum size for a name used by `Resolver`.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.scpi/index.md b/sdk/fidl/fuchsia.scpi/index.md
index dc6f92d..8bf43d3 100644
--- a/sdk/fidl/fuchsia.scpi/index.md
+++ b/sdk/fidl/fuchsia.scpi/index.md
@@ -206,16 +206,14 @@
 
 ## **CONSTANTS**
 
- System Control Power Interface
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.scpi/scpi.fidl#8">MAX_DVFS_OPPS</a></td>
             <td>
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.settings/index.md b/sdk/fidl/fuchsia.settings/index.md
index 6b32888..8636c33 100644
--- a/sdk/fidl/fuchsia.settings/index.md
+++ b/sdk/fidl/fuchsia.settings/index.md
@@ -213,6 +213,61 @@
             </td>
         </tr></table>
 
+## Privacy {:#Privacy}
+*Defined in [fuchsia.settings/privacy.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/privacy.fidl#7)*
+
+
+### Watch {:#Watch}
+
+ Notifies of a change in privacy settings.
+
+ On a given connection, the first call will return the current `settings` value while
+ subsequent calls will only return the new `settings` value upon a value change. This
+ follows the hanging get pattern.
+
+#### Request
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    </table>
+
+
+#### Response
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    <tr>
+            <td><code>result</code></td>
+            <td>
+                <code><a class='link' href='#Privacy_Watch_Result'>Privacy_Watch_Result</a></code>
+            </td>
+        </tr></table>
+
+### Set {:#Set}
+
+ Sets the privacy settings.
+
+ Any field not explicitly set in `settings` performs a no-op, and will not make any changes.
+
+#### Request
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    <tr>
+            <td><code>settings</code></td>
+            <td>
+                <code><a class='link' href='#PrivacySettings'>PrivacySettings</a></code>
+            </td>
+        </tr></table>
+
+
+#### Response
+<table>
+    <tr><th>Name</th><th>Type</th></tr>
+    <tr>
+            <td><code>result</code></td>
+            <td>
+                <code><a class='link' href='#Privacy_Set_Result'>Privacy_Set_Result</a></code>
+            </td>
+        </tr></table>
+
 ## System {:#System}
 *Defined in [fuchsia.settings/system.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/system.fidl#9)*
 
@@ -327,7 +382,7 @@
     <tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th></tr>
 </table>
 
-### System_Watch_Response {:#System_Watch_Response}
+### Privacy_Watch_Response {:#Privacy_Watch_Response}
 *Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#38)*
 
 
@@ -338,6 +393,35 @@
     <tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th></tr><tr>
             <td><code>settings</code></td>
             <td>
+                <code><a class='link' href='#PrivacySettings'>PrivacySettings</a></code>
+            </td>
+            <td></td>
+            <td>No default</td>
+        </tr>
+</table>
+
+### Privacy_Set_Response {:#Privacy_Set_Response}
+*Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#45)*
+
+
+
+
+
+<table>
+    <tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th></tr>
+</table>
+
+### System_Watch_Response {:#System_Watch_Response}
+*Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#52)*
+
+
+
+
+
+<table>
+    <tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th></tr><tr>
+            <td><code>settings</code></td>
+            <td>
                 <code><a class='link' href='#SystemSettings'>SystemSettings</a></code>
             </td>
             <td></td>
@@ -346,7 +430,7 @@
 </table>
 
 ### System_Set_Response {:#System_Set_Response}
-*Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#45)*
+*Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#59)*
 
 
 
@@ -770,6 +854,26 @@
 </td>
         </tr></table>
 
+### PrivacySettings {:#PrivacySettings}
+
+
+*Defined in [fuchsia.settings/privacy.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.settings/privacy.fidl#21)*
+
+
+
+<table>
+    <tr><th>Ordinal</th><th>Name</th><th>Type</th><th>Description</th></tr>
+    <tr>
+            <td>1</td>
+            <td><code>user_data_sharing_consent</code></td>
+            <td>
+                <code>bool</code>
+            </td>
+            <td> Reflects the user consent to have their user data shared with the product owner, e.g., for
+ metrics collection and crash reporting.
+</td>
+        </tr></table>
+
 ### SystemSettings {:#SystemSettings}
 
 
@@ -870,7 +974,7 @@
             <td></td>
         </tr></table>
 
-### System_Watch_Result {:#System_Watch_Result}
+### Privacy_Watch_Result {:#Privacy_Watch_Result}
 *Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#41)*
 
 
@@ -878,6 +982,44 @@
     <tr><th>Name</th><th>Type</th><th>Description</th></tr><tr>
             <td><code>response</code></td>
             <td>
+                <code><a class='link' href='#Privacy_Watch_Response'>Privacy_Watch_Response</a></code>
+            </td>
+            <td></td>
+        </tr><tr>
+            <td><code>err</code></td>
+            <td>
+                <code><a class='link' href='#Error'>Error</a></code>
+            </td>
+            <td></td>
+        </tr></table>
+
+### Privacy_Set_Result {:#Privacy_Set_Result}
+*Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#48)*
+
+
+<table>
+    <tr><th>Name</th><th>Type</th><th>Description</th></tr><tr>
+            <td><code>response</code></td>
+            <td>
+                <code><a class='link' href='#Privacy_Set_Response'>Privacy_Set_Response</a></code>
+            </td>
+            <td></td>
+        </tr><tr>
+            <td><code>err</code></td>
+            <td>
+                <code><a class='link' href='#Error'>Error</a></code>
+            </td>
+            <td></td>
+        </tr></table>
+
+### System_Watch_Result {:#System_Watch_Result}
+*Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#55)*
+
+
+<table>
+    <tr><th>Name</th><th>Type</th><th>Description</th></tr><tr>
+            <td><code>response</code></td>
+            <td>
                 <code><a class='link' href='#System_Watch_Response'>System_Watch_Response</a></code>
             </td>
             <td></td>
@@ -890,7 +1032,7 @@
         </tr></table>
 
 ### System_Set_Result {:#System_Set_Result}
-*Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#48)*
+*Defined in [fuchsia.settings/generated](https://fuchsia.googlesource.com/fuchsia/+/master/generated#62)*
 
 
 <table>
diff --git a/sdk/fidl/fuchsia.stash/index.md b/sdk/fidl/fuchsia.stash/index.md
index 0a402b8..41b2fe6 100644
--- a/sdk/fidl/fuchsia.stash/index.md
+++ b/sdk/fidl/fuchsia.stash/index.md
@@ -432,15 +432,16 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.stash/stash.fidl#9">MAX_STRING_SIZE</a></td>
             <td>
                     <code>12000</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td> Strings over 12 kb will be tossed. This number is chosen arbitrarily, if you
+ think it should be higher just ask.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.stash/stash.fidl#10">MAX_KEY_SIZE</a></td>
@@ -448,6 +449,7 @@
                     <code>256</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.sys/index.md b/sdk/fidl/fuchsia.sys/index.md
index 3c5b08b..cccdd8e 100644
--- a/sdk/fidl/fuchsia.sys/index.md
+++ b/sdk/fidl/fuchsia.sys/index.md
@@ -868,15 +868,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys/environment.fidl#8">kLabelMaxLength</a></td>
             <td>
                     <code>32</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum length for an environment label.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys/types.fidl#11">MAX_URL_LENGTH</a></td>
@@ -884,6 +884,7 @@
                     <code>2083</code>
                 </td>
                 <td><code>uint16</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.sys2/index.md b/sdk/fidl/fuchsia.sys2/index.md
index f5d62c2..54daf2e 100644
--- a/sdk/fidl/fuchsia.sys2/index.md
+++ b/sdk/fidl/fuchsia.sys2/index.md
@@ -2138,15 +2138,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/constants.fidl#7">MAX_FACET_NAME_LENGTH</a></td>
             <td>
                     <code>100</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/constants.fidl#8">MAX_CHILD_NAME_LENGTH</a></td>
@@ -2154,6 +2153,7 @@
                     <code>100</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/constants.fidl#9">MAX_COLLECTION_NAME_LENGTH</a></td>
@@ -2161,6 +2161,7 @@
                     <code>100</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/constants.fidl#10">MAX_STORAGE_NAME_LENGTH</a></td>
@@ -2168,6 +2169,7 @@
                     <code>100</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/constants.fidl#11">MAX_PATH_LENGTH</a></td>
@@ -2175,6 +2177,7 @@
                     <code>1024</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/constants.fidl#12">MAX_URL_LENGTH</a></td>
@@ -2182,6 +2185,7 @@
                     <code>4096</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/constants.fidl#13">MAX_MONIKER_LENGTH</a></td>
@@ -2189,6 +2193,7 @@
                     <code>4096</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/constants.fidl#16">ERR_COMPONENT_DIED</a></td>
@@ -2196,6 +2201,8 @@
                     <code>1</code>
                 </td>
                 <td><code>int32</code></td>
+            <td> Error produced when a component terminates unexpected.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.sys2/work_scheduler.fidl#9">MAX_WORK_ID_LENGTH</a></td>
@@ -2203,6 +2210,7 @@
                     <code>100</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.sysinfo/index.md b/sdk/fidl/fuchsia.sysinfo/index.md
index 1cae1e9..2894e41 100644
--- a/sdk/fidl/fuchsia.sysinfo/index.md
+++ b/sdk/fidl/fuchsia.sysinfo/index.md
@@ -170,15 +170,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysinfo/sysinfo.fidl#9">SYSINFO_BOARD_NAME_LEN</a></td>
             <td>
                     <code>32</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.sysmem/index.md b/sdk/fidl/fuchsia.sysmem/index.md
index 295d6c7..28aec74 100644
--- a/sdk/fidl/fuchsia.sysmem/index.md
+++ b/sdk/fidl/fuchsia.sysmem/index.md
@@ -2223,15 +2223,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#16">FORMAT_MODIFIER_NONE</a></td>
             <td>
                     <code>0</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#18">FORMAT_MODIFIER_VENDOR_NONE</a></td>
@@ -2239,6 +2238,7 @@
                     <code>0</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#19">FORMAT_MODIFIER_VENDOR_INTEL</a></td>
@@ -2246,6 +2246,7 @@
                     <code>72057594037927936</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#20">FORMAT_MODIFIER_VENDOR_AMD</a></td>
@@ -2253,6 +2254,7 @@
                     <code>144115188075855872</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#21">FORMAT_MODIFIER_VENDOR_NVIDIA</a></td>
@@ -2260,6 +2262,7 @@
                     <code>216172782113783808</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#22">FORMAT_MODIFIER_VENDOR_SAMSUNG</a></td>
@@ -2267,6 +2270,7 @@
                     <code>288230376151711744</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#23">FORMAT_MODIFIER_VENDOR_QCOM</a></td>
@@ -2274,6 +2278,7 @@
                     <code>360287970189639680</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#24">FORMAT_MODIFIER_VENDOR_VIVANTE</a></td>
@@ -2281,6 +2286,7 @@
                     <code>432345564227567616</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#25">FORMAT_MODIFIER_VENDOR_BROADCOM</a></td>
@@ -2288,6 +2294,7 @@
                     <code>504403158265495552</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#26">FORMAT_MODIFIER_VENDOR_ARM</a></td>
@@ -2295,6 +2302,7 @@
                     <code>576460752303423488</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#28">FORMAT_MODIFIER_VALUE_RESERVED</a></td>
@@ -2302,6 +2310,7 @@
                     <code>72057594037927935</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#30">FORMAT_MODIFIER_INVALID</a></td>
@@ -2309,6 +2318,7 @@
                     <code><a class='link' href='#FORMAT_MODIFIER_VALUE_RESERVED'>FORMAT_MODIFIER_VALUE_RESERVED</a></code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#32">FORMAT_MODIFIER_LINEAR</a></td>
@@ -2316,6 +2326,7 @@
                     <code>0</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#39">FORMAT_MODIFIER_INTEL_I915_X_TILED</a></td>
@@ -2323,6 +2334,7 @@
                     <code>72057594037927937</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#40">FORMAT_MODIFIER_INTEL_I915_Y_TILED</a></td>
@@ -2330,6 +2342,7 @@
                     <code>72057594037927938</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#41">FORMAT_MODIFIER_INTEL_I915_YF_TILED</a></td>
@@ -2337,6 +2350,7 @@
                     <code>72057594037927939</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#56">FORMAT_MODIFIER_ARM_AFBC_16x16</a></td>
@@ -2344,6 +2358,7 @@
                     <code>576460752303423489</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/format_modifier.fidl#57">FORMAT_MODIFIER_ARM_AFBC_32x8</a></td>
@@ -2351,6 +2366,7 @@
                     <code>576460752303423490</code>
                 </td>
                 <td><code>uint64</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#21">noneUsage</a></td>
@@ -2358,6 +2374,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#25">cpuUsageRead</a></td>
@@ -2365,6 +2382,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#26">cpuUsageReadOften</a></td>
@@ -2372,6 +2390,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#27">cpuUsageWrite</a></td>
@@ -2379,6 +2398,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#28">cpuUsageWriteOften</a></td>
@@ -2386,6 +2406,7 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#32">vulkanUsageTransferSrc</a></td>
@@ -2393,6 +2414,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#33">vulkanUsageTransferDst</a></td>
@@ -2400,6 +2422,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#34">vulkanUsageSampled</a></td>
@@ -2407,6 +2430,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#35">vulkanUsageStorage</a></td>
@@ -2414,6 +2438,7 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#36">vulkanUsageColorAttachment</a></td>
@@ -2421,6 +2446,7 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#37">vulkanUsageStencilAttachment</a></td>
@@ -2428,6 +2454,7 @@
                     <code>32</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#38">vulkanUsageTransientAttachment</a></td>
@@ -2435,6 +2462,7 @@
                     <code>64</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#39">vulkanUsageInputAttachment</a></td>
@@ -2442,6 +2470,7 @@
                     <code>128</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#42">displayUsageLayer</a></td>
@@ -2449,6 +2478,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#43">displayUsageCursor</a></td>
@@ -2456,6 +2486,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#47">videoUsageHwDecoder</a></td>
@@ -2463,6 +2494,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#48">videoUsageHwEncoder</a></td>
@@ -2470,6 +2502,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-sysmem/usages.fidl#51">videoUsageHwProtected</a></td>
@@ -2477,6 +2510,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.tracing.provider/index.md b/sdk/fidl/fuchsia.tracing.provider/index.md
index ac5ce16..8ee4c20 100644
--- a/sdk/fidl/fuchsia.tracing.provider/index.md
+++ b/sdk/fidl/fuchsia.tracing.provider/index.md
@@ -330,15 +330,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-tracing-provider/provider.fidl#10">MAX_PROVIDER_NAME_LENGTH</a></td>
             <td>
                     <code>100</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The maximum length of a provider's name.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-tracing-provider/provider.fidl#13">MAX_NUM_CATEGORIES</a></td>
@@ -346,6 +346,8 @@
                     <code>100</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The maximum number of categories supported.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/zircon/system/fidl/fuchsia-tracing-provider/provider.fidl#16">MAX_CATEGORY_NAME_LENGTH</a></td>
@@ -353,6 +355,8 @@
                     <code>100</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> The maximum length of a category name.
+</td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.ui.gfx/index.md b/sdk/fidl/fuchsia.ui.gfx/index.md
index f2061ce..e4d3514 100644
--- a/sdk/fidl/fuchsia.ui.gfx/index.md
+++ b/sdk/fidl/fuchsia.ui.gfx/index.md
@@ -4870,15 +4870,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.gfx/commands.fidl#705">kLabelMaxLength</a></td>
             <td>
                     <code>32</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Maximum length for a resource label.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.gfx/events.fidl#9">kMetricsEventMask</a></td>
@@ -4886,6 +4886,9 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Reports metrics information.
+ This event type is only reported for node resources.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.gfx/events.fidl#10">kSizeChangeHintEventMask</a></td>
@@ -4893,6 +4896,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.ui.input/index.md b/sdk/fidl/fuchsia.ui.input/index.md
index 26e71de..d486a7e 100644
--- a/sdk/fidl/fuchsia.ui.input/index.md
+++ b/sdk/fidl/fuchsia.ui.input/index.md
@@ -1818,15 +1818,15 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#8">kModifierNone</a></td>
             <td>
                     <code>0</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Keyboard modifiers
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#9">kModifierCapsLock</a></td>
@@ -1834,6 +1834,7 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#10">kModifierLeftShift</a></td>
@@ -1841,6 +1842,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#11">kModifierRightShift</a></td>
@@ -1848,6 +1850,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#12">kModifierShift</a></td>
@@ -1855,6 +1858,7 @@
                     <code>6</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#13">kModifierLeftControl</a></td>
@@ -1862,6 +1866,7 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#14">kModifierRightControl</a></td>
@@ -1869,6 +1874,7 @@
                     <code>16</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#15">kModifierControl</a></td>
@@ -1876,6 +1882,7 @@
                     <code>24</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#16">kModifierLeftAlt</a></td>
@@ -1883,6 +1890,7 @@
                     <code>32</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#17">kModifierRightAlt</a></td>
@@ -1890,6 +1898,7 @@
                     <code>64</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#18">kModifierAlt</a></td>
@@ -1897,6 +1906,7 @@
                     <code>96</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#19">kModifierLeftSuper</a></td>
@@ -1904,6 +1914,7 @@
                     <code>128</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#20">kModifierRightSuper</a></td>
@@ -1911,6 +1922,7 @@
                     <code>256</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#21">kModifierSuper</a></td>
@@ -1918,6 +1930,7 @@
                     <code>384</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#24">kMousePrimaryButton</a></td>
@@ -1925,6 +1938,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Mouse buttons
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#25">kMouseSecondaryButton</a></td>
@@ -1932,6 +1947,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#26">kMouseTertiaryButton</a></td>
@@ -1939,6 +1955,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#29">kStylusPrimaryButton</a></td>
@@ -1946,6 +1963,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Stylus buttons
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/input_event_constants.fidl#30">kStylusSecondaryButton</a></td>
@@ -1953,6 +1972,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/usages.fidl#8">kMouseButtonPrimary</a></td>
@@ -1960,6 +1980,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Common mouse buttons report constants
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/usages.fidl#9">kMouseButtonSecondary</a></td>
@@ -1967,6 +1989,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/usages.fidl#10">kMouseButtonTertiary</a></td>
@@ -1974,6 +1997,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/usages.fidl#13">kStylusBarrel</a></td>
@@ -1981,6 +2005,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Common stylus buttons report constants
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/usages.fidl#16">kVolumeUp</a></td>
@@ -1988,6 +2014,8 @@
                     <code>1</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td> Used as mask bits (2^N) against ButtonDescriptor.buttons.
+</td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/usages.fidl#17">kVolumeDown</a></td>
@@ -1995,6 +2023,7 @@
                     <code>2</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/usages.fidl#18">kMicMute</a></td>
@@ -2002,6 +2031,7 @@
                     <code>4</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.input/usages.fidl#19">kReset</a></td>
@@ -2009,6 +2039,7 @@
                     <code>8</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.ui.scenic/index.md b/sdk/fidl/fuchsia.ui.scenic/index.md
index 54fcdb6..e038a6b 100644
--- a/sdk/fidl/fuchsia.ui.scenic/index.md
+++ b/sdk/fidl/fuchsia.ui.scenic/index.md
@@ -443,15 +443,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.scenic/scenic.fidl#37">displayOwnedSignal</a></td>
             <td>
                     <code>33554432</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.scenic/scenic.fidl#38">displayNotOwnedSignal</a></td>
@@ -459,6 +458,7 @@
                     <code>16777216</code>
                 </td>
                 <td><code>uint32</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.wlan.mlme/index.md b/sdk/fidl/fuchsia.wlan.mlme/index.md
index 650eb04..79db1c1 100644
--- a/sdk/fidl/fuchsia.wlan.mlme/index.md
+++ b/sdk/fidl/fuchsia.wlan.mlme/index.md
@@ -4458,15 +4458,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.mlme/wlan_mlme.fidl#683">countryEnvironAll</a></td>
             <td>
                     <code>32</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.mlme/wlan_mlme.fidl#684">countryEnvironOutdoor</a></td>
@@ -4474,6 +4473,7 @@
                     <code>79</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.mlme/wlan_mlme.fidl#685">countryEnvironIndoor</a></td>
@@ -4481,6 +4481,7 @@
                     <code>73</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     <tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.mlme/wlan_mlme.fidl#686">countryEnvironNonCountry</a></td>
@@ -4488,6 +4489,7 @@
                     <code>88</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/fuchsia.wlan.stats/index.md b/sdk/fidl/fuchsia.wlan.stats/index.md
index 1585311..2726de3 100644
--- a/sdk/fidl/fuchsia.wlan.stats/index.md
+++ b/sdk/fidl/fuchsia.wlan.stats/index.md
@@ -284,15 +284,14 @@
 
 ## **CONSTANTS**
 
-
-
 <table>
-    <tr><th>Name</th><th>Value</th><th>Type</th></tr><tr>
+    <tr><th>Name</th><th>Value</th><th>Type</th><th>Description</th></tr><tr>
             <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.wlan.stats/wlan_stats.fidl#29">RSSI_BINS</a></td>
             <td>
                     <code>129</code>
                 </td>
                 <td><code>uint8</code></td>
+            <td></td>
         </tr>
     
 </table>
diff --git a/sdk/fidl/index.md b/sdk/fidl/index.md
index 88024fd..295e4ea 100644
--- a/sdk/fidl/index.md
+++ b/sdk/fidl/index.md
@@ -153,16 +153,10 @@
 </tr>
 <tr>
     <td><a href="fuchsia.hardware.pty/index">fuchsia.hardware.pty</a></td>
-    <td> A PTY (pseudoterminal) emulates terminal devices, with a &quot;server&quot; side
+    <td> A PTY (pseudoterminal) emulates terminal devices, with a "server" side
  (which represents the keyboard+monitor side of the terminal and is obtained
- by opening /dev/misc/ptmx) and a number of &quot;client&quot; sides which are obtained
- by calling `OpenClient`.
-
- Client PTYs are identified by the `id` used in the `OpenClient` call. The
- first Client PTY *must* be 0, and it is the only Client PTY that is allowed
- to create additional Client PTYs, receive Events, etc. It is the
- Controlling PTY.
-</td>
+ by opening /dev/misc/ptmx) and a number of "client" sides which are obtained
+ by calling `OpenClient`.</td>
 </tr>
 <tr>
     <td><a href="fuchsia.hardware.rtc/index">fuchsia.hardware.rtc</a></td>