diff --git a/spec/enrichments/tsdoc_v2/combined.json b/spec/enrichments/tsdoc_v2/combined.json
index 0467e800000..0c72523e032 100644
--- a/spec/enrichments/tsdoc_v2/combined.json
+++ b/spec/enrichments/tsdoc_v2/combined.json
@@ -79271,7 +79271,7 @@
                       "kindString": "Call signature",
                       "flags": {},
                       "comment": {
-                        "shortText": "Downloads a file."
+                        "shortText": "Downloads a file from a private bucket. For public buckets, make a request to the URL returned from `getPublicUrl` instead."
                       },
                       "parameters": [
                         {
diff --git a/spec/enrichments/tsdoc_v2/storage.json b/spec/enrichments/tsdoc_v2/storage.json
index d94d2aadde8..475ba699fc3 100644
--- a/spec/enrichments/tsdoc_v2/storage.json
+++ b/spec/enrichments/tsdoc_v2/storage.json
@@ -5251,7 +5251,7 @@
                   "kindString": "Call signature",
                   "flags": {},
                   "comment": {
-                    "shortText": "Downloads a file."
+                    "shortText": "Downloads a file from a private bucket. For public buckets, make a request to the URL returned from `getPublicUrl` instead."
                   },
                   "parameters": [
                     {
diff --git a/spec/enrichments/tsdoc_v2/storage_dereferenced.json b/spec/enrichments/tsdoc_v2/storage_dereferenced.json
index 2074da33442..634dd23b469 100644
--- a/spec/enrichments/tsdoc_v2/storage_dereferenced.json
+++ b/spec/enrichments/tsdoc_v2/storage_dereferenced.json
@@ -5550,7 +5550,7 @@
                   "kindString": "Call signature",
                   "flags": {},
                   "comment": {
-                    "shortText": "Downloads a file."
+                    "shortText": "Downloads a file from a private bucket. For public buckets, make a request to the URL returned from `getPublicUrl` instead."
                   },
                   "parameters": [
                     {
diff --git a/spec/gotrue_v1_config.yaml b/spec/gotrue_v1_config.yaml
index fd7e88431b2..31827802154 100644
--- a/spec/gotrue_v1_config.yaml
+++ b/spec/gotrue_v1_config.yaml
@@ -40,7 +40,7 @@ parameters:
     tags: ['general'] # {string[]} These tags are useful for grouping parameters
     required: true
     description: |
-     The base URL of your website. Used as an allow-list for redirects and for constructing URLs used in emails.
+      The base URL of your website. Used as an allow-list for redirects and for constructing URLs used in emails.
   - id: 'GOTRUE_URI_ALLOW_LIST' # {string} A unique identifier for this param.
     title: 'auth.additional_redirect_urls' # {string} Any name.
     tags: ['general'] # {string[]} These tags are useful for grouping parameters