From 257bb0c70dd0f0b11b6b819a404d0af4959f6a4e Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonel.ceruto@scnd.com>
Date: Thu, 2 May 2024 12:43:11 -0400
Subject: [PATCH] improve README.md

---
 README.md | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index cf121ba..d7e5802 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 [![License](https://poser.pugx.org/yceruto/option-type/license)](https://packagist.org/packages/yceruto/option-type)
 [![PHP Version Require](https://poser.pugx.org/yceruto/option-type/require/php)](https://packagist.org/packages/yceruto/option-type)
 
-The `Option` class represents a value that might or might not be there. It's all about
+The `Option` type represents a value that might or might not be there. It's all about
 null safety in PHP!
 
 > [!NOTE]
@@ -24,9 +24,6 @@ In PHP, denoting the absence of a value is done with `null`, e.g. when a `divide
 function returns `null` if the divisor is `0`.
 
 ```php
-/**
- * @return int|null
- */
 function divide(int $dividend, int $divisor): ?int
 {
     if (0 === $divisor) {
@@ -50,13 +47,13 @@ divide by zero. The function will return `null`, and the `success()` function wi
 a `TypeError` because it expects an `int` value, not `null`.
 
 The issue with this approach is that it's too easy to overlook checking if the value is 
-`null`, leading to runtime errors. This is where the `Option` class comes in handy: it 
-makes you deal with the possibility of a missing value, the `null` case.
+`null`, leading to runtime errors, and this is where the `Option` type comes in handy: it 
+always forces you to deal with the `null` case.
 
 ## Handling the presence or absence of a value with `Option`
 
 Options often work with pattern matching to check if there’s a value and act accordingly, 
-always making sure to handle the `None` case.
+always making sure to handle the `null` case.
 
 ```php
 use Std\Type\Option;