Add example on adding assertOptions to the sandbox

docs/release-source/release/examples/sandbox-configuration.test.js

@@ -0,0 +1,24 @@
+require("@fatso83/mini-mocha").install();
+const sinon = require("sinon");
+const { assert } = require("@sinonjs/referee");
+
+it("should allow limiting the length of the assert.fake output", function () {
+    const sb = sinon.createSandbox({
+        assertOptions: {
+            shouldLimitAssertionLogs: true,
+            assertionLogLimit: 10,
+        },
+    });
+    const reallyLongErrorMessage = "a long string repeated 100 times".repeat(
+        100,
+    );
+
+    assert.exception(
+        () => {
+            sb.assert.fail(reallyLongErrorMessage);
+        },
+        {
+            message: "a long str",
+        },
+    );
+});

docs/release-source/release/sandbox.md

@@ -107,6 +107,20 @@ console.log(Object.keys(sinon.inject(obj)))
     "requests",
 ```
 
+##### `assertOptions`
+
+You can override the default behavior and limit the amount of
+characters if the error strings should somehow be overwhelming
+and overflow your display.
+
+```javascript
+@property {boolean} shouldLimitAssertionLogs
+@property {number}  assertionLogLimit
+```
+
+<div data-example-id="sandbox-configuration"></div>
+```
+
 ##### `useFakeTimers`
 
 If set to `true`, the sandbox will have a `clock` property. You can optionally pass