From 610cf92d3900afb8fa0a1b3efc2459c1eee0153c Mon Sep 17 00:00:00 2001
From: sindri <33976067+isarsindri@users.noreply.github.com>
Date: Tue, 3 Mar 2026 12:28:27 +0100
Subject: [PATCH] Add warning for tweening reactive properties

Added a warning about tweening reactive properties and suggested alternatives.
---
 docs/api/animation.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/api/animation.md b/docs/api/animation.md
index 3e27322..2d5e3a0 100644
--- a/docs/api/animation.md
+++ b/docs/api/animation.md
@@ -55,6 +55,11 @@ Returns a new source with a value always moving torwards the input source value.
 
     This module is designed for UI animations (size, position, transparency, colour, etc.). It is safe to `require` in non-Roblox environments (it should fall back to applying goals           instantly).
 
+  ::: warning
+  	Avoid tweening frequently changing reactive properties directly. Prefer tweening on events (button press, open/close).
+  	For continuous motion, prefer spring.
+  :::
+
     ## Exports
 
     - `vide.tween.tweenTo(instance, goals, tweenInfo?) -> Tween?`