diff --git a/web/spec/supabase.yml b/web/spec/supabase.yml
index 2a9f9be505d..c902d9a2898 100644
--- a/web/spec/supabase.yml
+++ b/web/spec/supabase.yml
@@ -192,9 +192,9 @@ pages:
       npx openapi-typescript https://your-project.supabase.co/rest/v1/?apikey=your-anon-key --output types/supabase.ts
       ```
 
-      Important disclaimers:
+      Important notes:
 
-      - The generator can't know if a column is specified as an array, and will thus just generate the type as `string`, even though supabase handles this automatically and returns arrays.
+      - Since the generator uses JSON API, there is no way to determine if a column is an Array. It will generate array types as `string`, even though Supabase handles this automatically and returns arrays.
         You can fix this manually in the files by changing the type, e.g. `names: string` -> `names: string[]`
       - The types won't automatically stay in sync with your database, so make sure to regenerate your types after your make changes to your database.