invalidateRecords documentation

Signed-off-by: Piotr PG Gajek <[email protected]>

Author: pgajek2

website/docs/api/cached-soql/soql-cache.md

@@ -29,6 +29,7 @@ The following are methods for using `SOQLCache`:
 [**CACHE EXPIRATION**](#cache-expiration)
 
 - [`maxHoursWithoutRefresh()`](#maxhourswithoutrefresh)
+- [`invalidateRecords(List<SObject> records)`](#invalidaterecords)
 
 [**INITIAL QUERY**](#initial-query)
 
@@ -182,6 +183,24 @@ SOQLCache.of(Profile.SObjectType)
     .toObject();
 ```
 
+### invalidateRecords
+
+The `invalidateRecords` method allows clearing records from the cache, triggering an automatic refresh the next time the query is executed.
+
+**Signature**
+
+```apex
+Cacheable invalidateRecords(List<SObject> records)
+```
+
+**Example**
+
+```apex
+trigger SomeObjectTrigger on SomeObject (after update, after delete) {
+    SOQLCache.invalidateRecords(Trigger.old);
+}
+```
+
 ## INITIAL QUERY
 
 The initial query allows for the bulk population of records in the cache (if it is empty), ensuring that every subsequent query in the cached selector will use the cached records.