docs: improve README with real structure and troubleshooting tips#4837

ochola-rich wants to merge 2 commits intosupabase:developsupabase/cli:developfrom

ochola-rich:improve-readmeochola-rich/Supabase-ClI:improve-readmeCopy head branch name to clipboard