From 48a9607f1592750f7f8d66108a9eae53fa06cec7 Mon Sep 17 00:00:00 2001
From: Jobin Jacob Kavalam <jjkavalam@gmail.com>
Date: Mon, 14 Aug 2023 21:35:10 +0800
Subject: [PATCH] document 'throw' config of disks in filesystem.md

---
 filesystem.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/filesystem.md b/filesystem.md
index c90ee222e1..efc1485f70 100644
--- a/filesystem.md
+++ b/filesystem.md
@@ -7,6 +7,7 @@
     - [Driver Prerequisites](#driver-prerequisites)
     - [Scoped & Read-Only Filesystems](#scoped-and-read-only-filesystems)
     - [Amazon S3 Compatible Filesystems](#amazon-s3-compatible-filesystems)
+    - [Error handling](#error-handling)
 - [Obtaining Disk Instances](#obtaining-disk-instances)
     - [On-Demand Disks](#on-demand-disks)
 - [Retrieving Files](#retrieving-files)
@@ -205,6 +206,11 @@ AWS_URL=http://localhost:9000/local
 > **Warning**  
 > Generating temporary storage URLs via the `temporaryUrl` method is not supported when using MinIO.
 
+<a name="error-handling"></a>
+### Error handling 
+
+By default the various "disks" are configured to return a `false` value when an operation fails. However, it is possible to have the filesystem API throw the underlying exception by setting the corresponding disk's `throw` configuration to `true`. This can be particularly useful when troubleshooting filesystem-related problems.
+
 <a name="obtaining-disk-instances"></a>
 ## Obtaining Disk Instances