Merge branch 'release/3.0.1'

Author: lindyhopchris

CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file. This project adheres to
 [Semantic Versioning](http://semver.org/) and [this changelog format](http://keepachangelog.com/).
 
+## [3.0.1] - 2023-02-18
+
+### Changed
+
+- Update exceptions thrown when the encoding process fails to notify developer to check previous exception for the cause
+  of the failure.
+
 ## [3.0.0] - 2023-02-14
 
 ### Changed

src/Document.php

@@ -160,7 +160,11 @@ public function toArray()
         try {
             return json_decode($this->toJson(), true, 512, JSON_THROW_ON_ERROR);
         } catch (\Throwable $ex) {
-            throw new \LogicException('Unable to convert document to an array.', 0, $ex);
+            throw new \LogicException(
+                'Unable to convert document to an array. See previous exception for cause of failure.',
+                0,
+                $ex,
+            );
         }
     }
 
@@ -174,7 +178,11 @@ public function jsonSerialize(): array
 
             return $this->serialize();
         } catch (\Throwable $ex) {
-            throw new \LogicException('Unable to serialize compound document.', 0, $ex);
+            throw new \LogicException(
+                'Unable to serialize compound document. See previous exception for cause of failure.',
+                0,
+                $ex,
+            );
         }
     }
 
@@ -190,7 +198,11 @@ public function toJson($options = 0)
 
             return $this->encode();
         } catch (\Throwable $ex) {
-            throw new \LogicException('Unable to encode compound document.', 0, $ex);
+            throw new \LogicException(
+                'Unable to encode compound document. See previous exception for cause of failure.',
+                0,
+                $ex,
+            );
         }
     }