From 80b58deaad346cb64bc75b18a5d60789dbd5367a Mon Sep 17 00:00:00 2001
From: ComplexSpaces <complexspacescode@gmail.com>
Date: Tue, 4 Oct 2022 21:17:46 -0500
Subject: [PATCH] Add implementation comments

---
 src/apple/disk.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/apple/disk.rs b/src/apple/disk.rs
index 5f5150ec1..f37eaf07a 100644
--- a/src/apple/disk.rs
+++ b/src/apple/disk.rs
@@ -128,6 +128,10 @@ pub(super) fn get_disks() -> Vec<Disk> {
             None => continue,
         };
 
+        // Future note: There is a difference between `kCFURLVolumeIsBrowsableKey` and the
+        // `kCFURLEnumeratorSkipInvisibles` option of `CFURLEnumeratorOptions`. Specifically,
+        // the first one considers the writable `Data`(`/System/Volumes/Data`) partition to be
+        // browsable, while it is classified as "invisible" by CoreFoundation's volume emumerator.
         let browsable = unsafe {
             get_bool_value(
                 prop_dict.inner(),