Merge pull request #12862 from xikcode/patch-1

Improve Stats Overview Widgets documentation

packages/widgets/docs/02-stats-overview.md

@@ -42,6 +42,8 @@ Now, check out your widget in the dashboard.
 You may add a `description()` to provide additional information, along with a `descriptionIcon()`:
 
 ```php
+use Filament\Widgets\StatsOverviewWidget\Stat;
+
 protected function getStats(): array
 {
     return [
@@ -58,11 +60,24 @@ protected function getStats(): array
 }
 ```
 
+The `descriptionIcon()` method also accepts a second parameter to put the icon before the description instead of after it:
+
+```php
+use Filament\Support\Enums\IconPosition;
+use Filament\Widgets\StatsOverviewWidget\Stat;
+
+Stat::make('Unique views', '192.1k')
+    ->description('32k increase')
+    ->descriptionIcon('heroicon-m-arrow-trending-up', IconPosition::Before)
+```
+
 ## Changing the color of the stat
 
 You may also give stats a `color()` (`danger`, `gray`, `info`, `primary`, `success` or `warning`):
 
 ```php
+use Filament\Widgets\StatsOverviewWidget\Stat;
+
 protected function getStats(): array
 {
     return [
@@ -87,6 +102,8 @@ protected function getStats(): array
 You may also pass extra HTML attributes to stats using `extraAttributes()`:
 
 ```php
+use Filament\Widgets\StatsOverviewWidget\Stat;
+
 protected function getStats(): array
 {
     return [
@@ -108,6 +125,8 @@ In this example, we are deliberately escaping the `$` in `$dispatch()` since thi
 You may also add or chain a `chart()` to each stat to provide historical data. The `chart()` method accepts an array of data points to plot:
 
 ```php
+use Filament\Widgets\StatsOverviewWidget\Stat;
+
 protected function getStats(): array
 {
     return [