chore(docs): updating docs

docs/28.goffi.md

@@ -44,37 +44,31 @@ Now use `goffi()` to interop with your _Go_ program from _Php_.
 ```php
 <?php
 // src/main.php
+use CatPaw\Core\Unsafe;
 use function CatPaw\Core\goffi;
 use function CatPaw\Core\anyError;
 
 interface Contract {
  /**
  * Double a value.
- * @param int $value
- * @return Unsafe<int>
  */
- function DoubleIt(int $value):Unsafe;
+ function DoubleIt(int $value):int;
 }
 
-function main(){
+function main():Unsafe{
  return anyError(function(){
  $lib = goffi(Contract::class, './libgoffi.so')->try($error)
  or yield $error;
 
- $doubled = $lib->DoubleIt(3)->try($error)
- or yield $error;
+ $doubled = $lib->DoubleIt(3);
 
  echo "doubled: $doubled\n";
  });
 }
 ```
 
 > [!NOTE]
-> - Pay attention to the return type of `DoubleIt` in the Php interface, it's `Unsafe`.\
->  That is because all Go calls are treated as unsafe calls.\
->  When calling `goffi()`, your interface is being parsed through reflection.\
->  If any of your interface methods doesn't return an `Unsafe`, the `goffi()` call will fail.
-> - Go native errors may also be managed through this mechanism in the future.
+> If any of your interface methods doesn't specify a return type, the `goffi()` call will fail.
 
 Run the program.
 
@@ -108,26 +102,20 @@ Call _Greeting_ from php like so
 
 ```php
 <?php
+use CatPaw\Core\Unsafe;
 use function CatPaw\Core\anyError;
 use function CatPaw\Core\goffi;
-use CatPaw\Core\Unsafe;
 
 interface Contract {
- /**
- * Double a value.
- * @param int $value
- * @return Unsafe<void>
- */
- function Greeting(string $name):Unsafe;
+ function Greeting(string $name):void;
 }
 
 function main():Unsafe {
  return anyError(function() {
  $goffi = goffi(Contract::class, './libgoffi.so')->try($error)
  or yield $error;
 
- $goffi->Greeting('world')->try($error)
- or yield $error;
+ $goffi->Greeting('world');
  });
 }
 ```

src/scripts/Core/functions.php

@@ -409,10 +409,7 @@ function asFileName(string ...$path):string {
  * return error($error);
  * }
  *
- * $doubled = $lib->DoubleIt(3)->try($error);
- * if($error){
- * return error($error);
- * }
+ * $doubled = $lib->DoubleIt(3);
  * echo "doubled: $doubled\n";
  * }
  * ```