Fix some dox

src/Option.php

@@ -16,8 +16,10 @@
 use Traversable;
 
 /**
+ * Describes an optional value
+ *
  * @template T
- * Describes a Option
+ * The optional value
  */
 abstract class Option
 {
@@ -58,7 +60,6 @@ abstract public function unwrap();
      * Unwraps a result, yielding the content of a Some. Else, it returns optb.
      *
      * @param mixed $optb
-     * @psalm-param T $optb
      * @return mixed
      * @psalm-return T|mixed
      */
@@ -103,15 +104,17 @@ abstract public function mapOrElse(Closure $default, Closure $mapper);
      * Transforms the Option<T> into a Result<T, E>, mapping Some(v) to Ok(v) and None to Err(err).
      *
      * @param mixed $err
-     * @return Result<T, mixed>
+     * @return Result
+     * @psalm-return Result<T, mixed>
      */
     abstract public function okOr($err): Result;
 
     /**
      * Transforms the Option<T> into a Result<T, E>, mapping Some(v) to Ok(v) and None to Err(err()).
      *
      * @param Closure $err
-     * @return Result<T, mixed>
+     * @return Result
+     * @psalm-return Result<T, mixed>
      */
     abstract public function okOrElse(Closure $err): Result;
 

src/Option/None.php

@@ -17,8 +17,10 @@
 use Prewk\Result\Err;
 
 /**
+ * No value
+ *
  * @template T
- * None
+ * The optional value
  *
  * @inherits Option<T>
  */

src/Option/Some.php

@@ -17,8 +17,10 @@
 use Prewk\Result\Ok;
 
 /**
+ * Some value
+ *
  * @template T
- * Some
+ * The optional value
  *
  * @inherits Option<T>
  */