From ce23b9f3cd18599da102f8d0ff78c78d1b5a9dbf Mon Sep 17 00:00:00 2001
From: Nick Fisher <nick.fisher@avinium.com>
Date: Mon, 23 Jun 2025 12:25:18 +0800
Subject: [PATCH] (doc) add documentation for destroyAsset instances

---
 .../src/filament/src/implementation/ffi_filament_app.dart    | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/thermion_dart/lib/src/filament/src/implementation/ffi_filament_app.dart b/thermion_dart/lib/src/filament/src/implementation/ffi_filament_app.dart
index 83b7212f..01bf254d 100644
--- a/thermion_dart/lib/src/filament/src/implementation/ffi_filament_app.dart
+++ b/thermion_dart/lib/src/filament/src/implementation/ffi_filament_app.dart
@@ -261,7 +261,10 @@ class FFIFilamentApp extends FilamentApp<Pointer> {
     _onDestroy.clear();
   }
 
-  ///
+  /// If [asset] is actually an instance (i.e. was created via createInstance), 
+  /// its resources may not actually be destroyed until the parent asset is 
+  /// destroyed. It may be marked as unused, and recycled the next time 
+  /// createInstance is called.
   ///
   ///
   Future destroyAsset(covariant FFIAsset asset) async {