docs: moved command descriptions from docs repo (#3533)

docs: add long descriptions to some commands for documentation

Descriptions were added for some of these commands over in the [docs
repo](https://github.com/supabase/supabase/pull/35490/files), but the
spec auto-generation will overwrite them there. Adding to the command
description here instead.

Author: charislam

docs/supabase/config/push.md

@@ -0,0 +1,5 @@
+# supabase-config-push
+
+Updates the configurations of a linked Supabase project with the local `supabase/config.toml` file.
+
+This command allows you to manage project configuration as code by defining settings locally and then pushing them to your remote project.

docs/supabase/functions.md

@@ -0,0 +1,9 @@
+## supabase-functions
+
+Manage Supabase Edge Functions.
+
+Supabase Edge Functions are server-less functions that run close to your users.
+
+Edge Functions allow you to execute custom server-side code without deploying or scaling a traditional server. They're ideal for handling webhooks, custom API endpoints, data validation, and serving personalized content.
+
+Edge Functions are written in TypeScript and run on Deno compatible edge runtime, which is a secure runtime with no package management needed, fast cold starts, and built-in security.

docs/supabase/functions/new.md

@@ -0,0 +1,7 @@
+## supabase-functions-new
+
+Creates a new Edge Function with boilerplate code in the `supabase/functions` directory.
+
+This command generates a starter TypeScript file with the necessary Deno imports and a basic function structure. The function is created as a new directory with the name you specify, containing an `index.ts` file with the function code.
+
+After creating the function, you can edit it locally and then use `supabase functions serve`  to test it before deploying with `supabase functions deploy`.

docs/supabase/gen.md

@@ -0,0 +1,9 @@
+## supabase-gen
+
+Automatically generates type definitions based on your Postgres database schema.
+
+This command connects to your database (local or remote) and generates typed definitions that match your database tables, views, and stored procedures. By default, it generates TypeScript definitions, but also supports Go and Swift.
+
+Generated types give you type safety and autocompletion when working with your database in code, helping prevent runtime errors and improving developer experience.
+
+The types respect relationships, constraints, and custom types defined in your database schema.

docs/supabase/projects.md

@@ -0,0 +1,7 @@
+## supabase-projects
+
+Provides tools for creating and managing your Supabase projects.
+
+This command group allows you to list all projects in your organizations, create new projects, delete existing projects, and retrieve API keys. These operations help you manage your Supabase infrastructure programmatically without using the dashboard.
+
+Project management via CLI is especially useful for automation scripts and when you need to provision environments in a repeatable way.

docs/supabase/secrets.md

@@ -0,0 +1,11 @@
+## supabase-secrets
+
+Provides tools for managing environment variables and secrets for your Supabase project.
+
+This command group allows you to set, unset, and list secrets that are securely stored and made available to Edge Functions as environment variables.
+
+Secrets management through the CLI is useful for:
+- Setting environment-specific configuration
+- Managing sensitive credentials securely
+
+Secrets can be set individually or loaded from .env files for convenience.