Update README.md

Author: stevebauman

README.md

@@ -1,7 +1,10 @@
 <div align="center">
 <h1>Privacy Filter</h1>
 <p>
-<a href="https://github.com/DirectoryTree/PrivacyFilter/actions/workflows/run-tests.yml"><img src="https://github.com/DirectoryTree/PrivacyFilter/actions/workflows/run-tests.yml/badge.svg?branch=master" alt="Tests status"></a>
+<a href="https://github.com/DirectoryTree/PrivacyFilter/actions"><img src="https://img.shields.io/github/actions/workflow/status/DirectoryTree/PrivacyFilter/run-tests.yml?branch=master&style=flat-square" alt="Tests status"></a>
+<a href="https://packagist.org/packages/directorytree/privacy-filter"><img src="https://img.shields.io/packagist/dt/directorytree/privacy-filter.svg?style=flat-square" alt="Total downloads"></a>
+<a href="https://packagist.org/packages/directorytree/privacy-filter"><img src="https://img.shields.io/packagist/v/directorytree/privacy-filter.svg?style=flat-square" alt="Latest version"></a>
+<a href="https://packagist.org/packages/directorytree/privacy-filter"><img src="https://img.shields.io/github/license/DirectoryTree/PrivacyFilter?style=flat-square" alt="License"></a>
 </p>
 <p>Install and use compiled <a href="https://github.com/DirectoryTree/PrivacyFilterBinaries"><code>privacy-filter.cpp</code></a> binaries from Laravel applications.</p>
 </div>
@@ -113,6 +116,25 @@ Each entity contains the detected type, original text, byte offsets, and confide
 $length = $entity->length();
 ```
 
+You may use the detected entities to redact personal information from text:
+
+```php
+use DirectoryTree\PrivacyFilter\Facades\PrivacyFilter;
+
+$text = 'Contact John Doe at jdoe@example.com or 555-0100.';
+
+$entities = PrivacyFilter::entities($text);
+
+$redacted = str($entities)->reduce(
+    fn ($text, $entity) => str_replace($entity->text, '[redacted]', $text),
+    $text,
+);
+
+echo $redacted;
+
+// Contact [redacted] at [redacted] or [redacted].
+```
+
 ## Thresholds
 
 The classifier uses a default threshold of `0.5`. The threshold is the minimum confidence score an entity must meet before it is returned. Increasing the threshold returns fewer, higher-confidence entities, while decreasing it may return more entities with lower confidence.