Updated readme

Author: feketegy

README.md

@@ -19,7 +19,17 @@ Import it in your code:
 import "github.com/primalskill/errors"
 ```
 
-## Basic Usage
+## Running the Tests
+
+Navigate to the module's directory and execute:
+
+```bash
+make test
+```
+
+## Example - Basic Usage
+
+You can find more examples in the [docs](https://pkg.go.dev/github.com/primalskill/errors#pkg-examples).
 
 ```go
 package main
@@ -30,21 +40,65 @@ import (
 )
 
 func main() {
-  err1 := errors.E("this is an error", errors.WithMeta("metaKey1", "meta value 1", "isAuth", true))
-  err2 := errors.E("embedded error", err1, errors.WithMeta("additionalMeta", 246))
 
-  fmt.Println(err2.Error()) // outputs the error message: embedded error
+  // Define an error
+  err1 := errors.E(
+    "some error", 
+    errors.WithMeta(
+      "metaKey1", "meta value", 
+      "isAuth", true,
+    ),
+  )
+
+  // Define another error and wrap err1
+  err2 := errors.E(
+    "wrapped error", 
+    err1, 
+    errors.WithMeta(
+      "additionalMeta", 246,
+    ),
+  )
+
+  fmt.Println(err2.Error()) // output: "wrapped error"
 
   // Convert stdlib error to errors.Error
   var ee *errors.Error
   errors.As(err2, &ee)
+  fmt.Printf("%+v", ee.Meta) // output: [additionalMeta:246]
+
+  // GetMeta helper func
+  m, ok := errors.GetMeta(err1)
+  fmt.Printf("\n%+v\n%+v\n", ok, m) // output: true \n [metaKey1:meta value isAuth:true]
+
+  // Unwrap err2 to get err1
+  uErr := errors.Unwrap(err2)
+  fmt.Println(uErr.Error()) // output: "some error"
+}
+```
+
+## Example - Mirror an Existing Error
 
-  fmt.Printf("%+v", ee.Meta) // outputs err2 Meta
+```go
+package main
 
-  m := errors.GetMeta(err2) // get the Meta with a helper func
-  fmt.Printf("%+v", m) // outputs the Meta attached to err2
+import (
+  "fmt"
+  "github.com/primalskill/errors"
+)
 
-  uErr := errors.Unwrap(err2) // unwraps err2 to get err1
-  fmt.Println(uErr.Error()) // outputs: this is an error
+func main() {
+
+  // Define an error
+  err1 := errors.E("this is an error", errors.WithMeta("key1", "val1"))
+
+  // Preload or "mirror" err1 in err2 with a few rules:
+  // - err2 preloads err1 message
+  // - err2 preloads err1 Meta key/value pairs
+  // - if additional metas are defined on err2 it will merge it to the others
+  // - err2 overwrites err1 source location to correctly show the location where err2 was executed
+  err2 := errors.M(err1, errors.WithMeta("key2", "val2"))
+
+  fmt.Printf("%+v", errors.PrettyPrint(err2))
 }
 ```
+