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