docs: DOC-684: add webgl chrome limitations

plugins/plotly-express/docs/limitations.md

@@ -0,0 +1,20 @@
+# Limitations
+
+## Chrome WebGL Limit
+Chrome has a limit of 8 WebGL contexts active at one time.
+If more than 8 charts that use WebGL are created, the earliest charts appear as empty.
+Options to work around this include:
+1. Using Firefox, which has a higher limit.
+2. Setting `render_mode = "svg"` when creating the chart where possible, such as in scatter charts.
+Some charts, such as 3D charts and maps, do not provide this option as they require WebGL.
+3. Disabling WebGL in the Deephaven settings. Charts that require WebGl will still render in WebGL when available.
+4. Setting Chrome to allow more WebGL contexts with the `--max-active-webgl-contexts` flag.
+For example, to set the limit to 64:
+```bash
+--max-active-webgl-contexts=64
+```
+See more on flags [here](https://www.chromium.org/developers/how-tos/run-chromium-with-flags/).
+
+> [!WARNING]
+> Disabling WebGL, either in the settings or per chart, can lead to performance issues when plotting large datasets.
+

plugins/plotly-express/docs/sidebar.json

@@ -144,6 +144,10 @@
             "path": "static-image-export.md"
           }
         ]
+      },
+      {
+        "label": "Limitations",
+        "path": "limitations.md"
       }
     ]
   }