From 3d428067386e2b2149b0ac2da7340f83bab477f2 Mon Sep 17 00:00:00 2001
From: MzyzzG <124270525+MzyzzG@users.noreply.github.com>
Date: Mon, 27 Apr 2026 13:22:21 +0100
Subject: [PATCH] Update README.md

docs: add note about WebGL-based traces and debugging behavior
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index c57d5027cb6..24bbda91734 100644
--- a/README.md
+++ b/README.md
@@ -130,6 +130,15 @@ Official plotly.js documentation is hosted at [https://plotly.com/javascript](ht
 These pages are generated by the Plotly [graphing-library-docs repo](https://github.com/plotly/graphing-library-docs) built with [Jekyll](https://jekyllrb.com/) and publicly hosted on GitHub Pages.
 For more info about contributing to Plotly documentation, please read through [contributing guidelines](https://github.com/plotly/graphing-library-docs/blob/master/README.md).
 
+---
+## Notes on WebGL-based traces
+
+Some trace types such as `scattergl` use WebGL for improved performance with large datasets.
+
+When working in development or debugging environments, certain WebGL-related warnings (for example, related to buffer clearing) may appear if rendering operations are not fully specified.
+
+These warnings are expected in strict/debug contexts and can typically be resolved by ensuring that rendering calls (such as `regl.clear()`) explicitly define the intended buffers.
+
 ---
 ## Bugs and feature requests