diff --git a/docs/src/examples/hidden.md b/docs/src/examples/hidden.md
index e260ebcd..a3ca4422 100644
--- a/docs/src/examples/hidden.md
+++ b/docs/src/examples/hidden.md
@@ -9,8 +9,11 @@ You can toggle the visibility of nodes by simply setting their `hidden` attribut
Edges that are connected to a hidden node will also be hidden.
-If you set the `onlyRenderVisibleElements` prop to `true`, hidden elements will not be rendered at all instead of just hiding them with
-css. This behavior is disabled by default, meaning all elements are rendered whether they are hidden or not.
+If you set the `onlyRenderVisibleElements` prop to `true`, only elements that are visible inside the current viewpane will be rendered.
+This behavior is disabled by default, meaning all elements are rendered whether they are inside the view or not.
+
+This can save you some time on initial renders but consider that moving the pane can cause multiple renders of nodes into the dom,
+which can cause performance spikes depending on the complexity of the components that have to be mounted.