Add beginner onboarding documentation proposal

[rayaparsa-a11y]

Summary

This contribution proposes beginner-focused onboarding improvements for the supabase-py documentation.

Changes include:

• Clarification of Python virtual environment setup and the uv workflow
• Explanation of synchronous vs asynchronous clients
• Common beginner troubleshooting examples
• Suggested onboarding sequence for first-time contributors
• Recommended locations for future documentation integration

Motivation

While reviewing the repository as a new contributor, I identified several areas where additional explanation could make onboarding easier for beginners who may be unfamiliar with Python environments, async workflows, and repository navigation.

These notes are intended as a documentation-focused contribution and starting point for discussion around improving contributor onboarding.

[silentworks]

A lot of the thinks you are mentioning in this documentation are things a python developer should already be familiar with. The aim of the project is not to teach a python developer the basics as this should be learnt by doing research and building their skills. This document will just become a maintainers burden without much gain from it.

[rayaparsa-a11y]

Thank you for the feedback. I appreciate you taking the time to review the proposal. My perspective came from exploring the repository as a first-time contributor and noting areas that I found confusing during onboarding. I understand your concern about documenting general Python concepts that may be outside the scope of this project. I'll revisit the proposal and look for ways to focus more on repository-specific onboarding and contributor guidance.

Thanks again for the input!