diff --git a/models/descriptions/tables/fact_trust_lines.md b/models/descriptions/tables/fact_trust_lines.md
index 500ec69..b2c86f8 100644
--- a/models/descriptions/tables/fact_trust_lines.md
+++ b/models/descriptions/tables/fact_trust_lines.md
@@ -1,7 +1,9 @@
 {% docs core__fact_trust_lines %}
 
-Trustlines track authorized and deleted lines of trust between an account and assets. This table can be viewed as a subentry to an account because all trustlines must be associated with a single account. The trust line also tracks the balance of the asset held by the account and any buying or selling liabilities on the orderbook for a given account and asset. You do not have to hold a balance of an asset to trust the asset.
+FACT_TRUST_LINES table captures trust relationship events and balance states at time of transaction activity on the Stellar network. Each record represents the trustline state (balance, limits, liabilities) for an account-asset pair as recorded when a transaction affecting that trustline occurred. NOTE: This is NOT a comprehensive daily snapshot of all account balances - it only contains records when trustlines are created, modified, or involved in transactions.
 
-Learn more about Stellar trust lines: https://developers.stellar.org/docs/data/analytics/hubble/data-catalog/data-dictionary/trustlines
+To reconstruct the current or historical balance state for analysis, you must identify the most recent record per account-asset pair using techniques like ROW_NUMBER() OVER (PARTITION BY account_id, asset_id ORDER BY ledger_sequence DESC). The table includes balance changes triggered by payments, trades, trustline modifications, and other operations, but accounts with no recent activity will not have recent records.
+
+Key data points include ASSET_CODE, ASSET_ISSUER, BALANCE (at transaction time), TRUST_LINE_LIMIT, BUYING_LIABILITIES, and SELLING_LIABILITIES. The DELETED flag indicates trustline removal. This transactional approach means supply calculations require careful aggregation of the latest state per account to avoid double-counting and to account for inactive accounts not represented in recent data.
 
 {% enddocs %}
\ No newline at end of file