Enhancing Supabase Documentation Request #21630
Daniel-HyunHo-Shin
started this conversation in
General
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
-
I wrote this as a comment to recent Supabase youtube video but I think it's a good idea to post it here too.
I really appreciate the documentation Supabase provides; however, I find it lacks detailed information.
For example, when looking at the 'Retrieve a session' section in Supabase's Dart client documentation, it only offers a brief description of this feature with a single sentence: 'Returns the session data, if there is an active session'.
On the other hand, AWS Amplify's documentation goes into much greater detail on how to manage credentials within Amplify. It clearly assures users that they do not need to worry about these aspects themselves, providing much more comprehensive guidance.
Upon reviewing Supabase's documentation, I noticed its tendency to be concise, which initially seemed advantageous due to its direct approach.
However, this conciseness becomes problematic when developing a production-level application, as the documentation omits detailed information on abstracted features.
I hope Supabase can enhance its documentation with more comprehensive details. This is especially critical since finding extensive articles on Supabase is currently challenging. The AWS Amplify documentation is a great example to follow. Additionally, I admire the style of Cloudflare's documentation , which could also serve as inspiration for Supabase.
Beta Was this translation helpful? Give feedback.
All reactions