Update README.md

Author: MatanYadaev

README.md

@@ -6,92 +6,98 @@
 ![Lint](https://github.com/matanyadaev/laravel-eloquent-spatial/workflows/Lint/badge.svg)
 [![Total Downloads](https://img.shields.io/packagist/dt/matanyadaev/laravel-eloquent-spatial.svg?style=flat-square)](https://packagist.org/packages/matanyadaev/laravel-eloquent-spatial)
 
-Laravel package to work with spatial data types and functions.
+**This Laravel package allows you to easily work with spatial data types and functions.**
 
-The latest version (v3) supports Laravel 10 and PHP 8.1+. For Laravel 8 or 9, and PHP 8.0, use v2.
+The latest version, v3, supports Laravel 10 and PHP 8.1+. For Laravel 8 or 9, and PHP 8.0, use v2.
 
 This package supports MySQL v8, MySQL v5.7, and MariaDB v10.
 
-## Installation
+## Getting Started
+
+### Installing the Package
 
 You can install the package via composer:
 
 ```bash
 composer require matanyadaev/laravel-eloquent-spatial
 ```
 
-## Quickstart
-Generate a new model with a migration file:
-```bash
-php artisan make:model {modelName} --migration
-```
+### Setting Up Your First Model
 
-Add some spatial columns to the migration file:
+1. First, generate a new model along with a migration file by running:
 
-```php
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
+   ```bash
+   php artisan make:model {modelName} --migration
+   ```
 
-class CreatePlacesTable extends Migration
-{
-    public function up(): void
-    {
-        Schema::create('places', static function (Blueprint $table) {
-            $table->id();
-            $table->string('name')->unique();
-            $table->point('location')->nullable();
-            $table->polygon('area')->nullable();
-            $table->timestamps();
-        });
-    }
+2. Next, add some spatial columns to the migration file. For instance, to create a "places" table:
+
+    ```php
+    use Illuminate\Database\Migrations\Migration;
+    use Illuminate\Database\Schema\Blueprint;
 
-    public function down(): void
+    class CreatePlacesTable extends Migration
     {
-        Schema::dropIfExists('places');
+        public function up(): void
+        {
+            Schema::create('places', static function (Blueprint $table) {
+                $table->id();
+                $table->string('name')->unique();
+                $table->point('location')->nullable();
+                $table->polygon('area')->nullable();
+                $table->timestamps();
+            });
+        }
+
+        public function down(): void
+        {
+            Schema::dropIfExists('places');
+        }
     }
-}
-```
+    ```
 
-Run the migration:
+3. Run the migration:
 
-```bash
-php artisan migrate
-```
+    ```bash
+    php artisan migrate
+    ```
 
-Fill the `$fillable` and `$casts` arrays and use the `HasSpatial` trait in your new model:
+4. In your new model, fill the `$fillable` and `$casts` arrays and use the `HasSpatial` trait:
 
-```php
-namespace App\Models;
+    ```php
+    namespace App\Models;
 
-use Illuminate\Database\Eloquent\Model;
-use MatanYadaev\EloquentSpatial\SpatialBuilder;
-use MatanYadaev\EloquentSpatial\Objects\Point;
-use MatanYadaev\EloquentSpatial\Objects\Polygon;
-use MatanYadaev\EloquentSpatial\Traits\HasSpatial;
+    use Illuminate\Database\Eloquent\Model;
+    use MatanYadaev\EloquentSpatial\SpatialBuilder;
+    use MatanYadaev\EloquentSpatial\Objects\Point;
+    use MatanYadaev\EloquentSpatial\Objects\Polygon;
+    use MatanYadaev\EloquentSpatial\Traits\HasSpatial;
 
-/**
- * @property Point $location
- * @property Polygon $area
- * @method static SpatialBuilder query()
- */
-class Place extends Model
-{
-    use HasSpatial;
-
-    protected $fillable = [
-        'name',
-        'location',
-        'area',
-    ];
-
-    protected $casts = [
-        'location' => Point::class,
-        'area' => Polygon::class,
-    ];
-}
-```
+    /**
+     * @property Point $location
+     * @property Polygon $area
+     * @method static SpatialBuilder query()
+     */
+    class Place extends Model
+    {
+        use HasSpatial;
+
+        protected $fillable = [
+            'name',
+            'location',
+            'area',
+        ];
+
+        protected $casts = [
+            'location' => Point::class,
+            'area' => Polygon::class,
+        ];
+    }
+    ```
+
+### Interacting with Spatial Data
 
-Access spatial data:
+After setting up your model, you can now create and access spatial data. Here's an example:
 
 ```php
 use App\Models\Place;
@@ -140,13 +146,13 @@ echo $whiteHouse->location->srid; // 4326
 echo $vacationCity->area->toJson(); // {"type":"Polygon","coordinates":[[[41.90746728266806,12.455363273620605],[41.906636872349075,12.450309991836548],[41.90197359839437,12.445632219314575],[41.90027269624499,12.447413206100464],[41.90000118654431,12.457906007766724],[41.90281205461268,12.458517551422117],[41.903107507989986,12.457584142684937],[41.905918239316286,12.457734346389769],[41.90637337450963,12.45572805404663],[41.90746728266806,12.455363273620605]]]}
 ```
 
-## API
+## Further Reading
 
-Please see [API](API.md) for more informative API documentation.
+For more comprehensive documentation on the API, please refer to the [API](API.md) page.
 
-## Tip for better IDE support
+## Tips for Improving IDE Support
 
-In order to get better IDE support, you should add a `query` method phpDoc annotation to your model:
+In order to get better IDE support, you can add a `query` method phpDoc annotation to your model:
 
 ```php
 /**
@@ -158,7 +164,7 @@ class Place extends Model
 }
 ```
 
-Or alternatively override the method:
+Or you could override the method:
 
 ```php
 class Place extends Model
@@ -179,9 +185,9 @@ Place::whereDistance(...); // This is not
 
 ## Extension
 
-You can extend the package by adding macro methods to the `Geometry` class.
+You can add new methods to the `Geometry` class through macros.
 
-Register a macro in the `boot` method of your service provider:
+Here's an example of how to register a macro in your service provider's `boot` method:
 
 ```php
 class AppServiceProvider extends ServiceProvider
@@ -196,7 +202,7 @@ class AppServiceProvider extends ServiceProvider
 }
 ```
 
-Use the macro in your code:
+Use the method in your code:
 
 ```php
 $londonEyePoint = new Point(51.5032973, -0.1217424);
@@ -206,15 +212,17 @@ echo $londonEyePoint->getName(); // Point
 
 ## Development
 
-* Test: `composer pest`
-* Test with coverage: `composer pest-coverage`
-* Type check: `composer phpstan`
-* Format: `composer php-cs-fixer`
+Here are some useful commands for development:
+
+* Run tests: `composer pest`
+* Run tests with coverage: `composer pest-coverage`
+* Perform type checking: `composer phpstan`
+* Format your code: `composer php-cs-fixer`
 
-## Changelog
+## Updates and Changes
 
-Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
+For details on updates and changes, please refer to our [CHANGELOG](CHANGELOG.md).
 
 ## License
 
-The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
+Laravel Eloquent Spatial is released under The MIT License (MIT). For more information, please see our [License File](LICENSE.md).