docs: Rewrite GraphQL API documentation for quality and consistency (#601)

Author: muhsinking

docs.json

@@ -298,11 +298,11 @@
               {
                 "group": "GraphQL API",
                 "pages": [
-                  "references/graphql-spec",
                   "sdks/graphql/configurations",
                   "sdks/graphql/manage-pods",
                   "sdks/graphql/manage-pod-templates",
-                  "sdks/graphql/manage-endpoints"
+                  "sdks/graphql/manage-endpoints",
+                  "references/graphql-spec"
                 ]
               },
               {

sdks/graphql/configurations.mdx

@@ -1,47 +1,62 @@
 ---
-title: "Configurations"
+title: "Overview"
+sidebarTitle: "Overview"
+description: "Use the GraphQL API to manage Pods, templates, and Serverless endpoints programmatically."
 ---
 
-For details on queries, mutations, fields, and inputs, see the [Runpod GraphQL Spec](https://graphql-spec.runpod.io/).
-
-When configuring your environment, certain arguments are essential to ensure the correct setup and operation. Below is a detailed overview of each required argument:
-
-### `containerDiskInGb`
-
-* **Description**: Specifies the size of the disk allocated for the container in gigabytes. This space is used for the operating system, installed applications, and any data generated or used by the container.
-* **Type**: Integer
-* **Example**: `10` for a 10 GB disk size.
-
-### `dockerArgs`
-
-* **Description**: If specified, overrides the [container start command](https://docs.docker.com/engine/reference/builder/#cmd). If this argument is not provided, it will rely on the start command provided in the docker image.
-* **Type**: String
-* **Example**: `sleep infinity` to run the container in the background.
-
-### `env`
-
-* **Description**: A set of environment variables to be set within the container. These can configure application settings, external service credentials, or any other configuration data required by the software running in the container.
-* **Type**: Dictionary or Object
-* **Example**: `{"DATABASE_URL": "postgres://user:password@localhost/dbname"}`.
-
-### `imageName`
-
-* **Description**: The name of the Docker image to use for the container. This should include the repository name and tag, if applicable.
-* **Type**: String
-* **Example**: `"nginx:latest"` for the latest version of the Nginx image.
-
-### `name`
-
-* **Description**: The name assigned to the container instance. This name is used for identification and must be unique within the context it's being used.
-* **Type**: String
-* **Example**: `"my-app-container"`.
-
-### `volumeInGb`
-
-* **Description**: Defines the size of an additional persistent volume in gigabytes. This volume is used for storing data that needs to persist between container restarts or redeployments.
-* **Type**: Integer
-* **Example**: `5` for a 5GB persistent volume.
-
-Ensure that these arguments are correctly specified in your configuration to avoid errors during deployment.
-
-Optional arguments may also be available, providing additional customization and flexibility for your setup.
+Use the GraphQL API to manage Pods, templates, and Serverless endpoints through queries and mutations.
+
+All requests go to `https://api.runpod.io/graphql` with your API key included as a query parameter. For the complete schema including all available queries, mutations, fields, and inputs, see the [GraphQL Spec](https://graphql-spec.runpod.io/).
+
+## Quick start
+
+Make a request using cURL:
+
+```bash
+curl --request POST \
+  --header 'content-type: application/json' \
+  --url 'https://api.runpod.io/graphql?api_key=YOUR_API_KEY' \
+  --data '{"query": "query { myself { id email } }"}'
+```
+
+Or use a GraphQL client:
+
+```graphql
+query {
+  myself {
+    id
+    email
+  }
+}
+```
+
+## Common operations
+
+<CardGroup cols={2}>
+  <Card title="Manage Pods" href="/sdks/graphql/manage-pods" icon="server" horizontal>
+    Create, start, stop, and query Pods.
+  </Card>
+  <Card title="Manage templates" href="/sdks/graphql/manage-pod-templates" icon="layer-group" horizontal>
+    Create and manage Pod and Serverless templates.
+  </Card>
+  <Card title="Manage endpoints" href="/sdks/graphql/manage-endpoints" icon="bolt" horizontal>
+    Create and configure Serverless endpoints.
+  </Card>
+</CardGroup>
+
+## Common input fields
+
+The following fields are commonly used when creating Pods and templates.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `containerDiskInGb` | Integer | Size of the container disk in GB. Used for the operating system, installed applications, and temporary data. |
+| `volumeInGb` | Integer | Size of the persistent volume in GB. Data persists between Pod restarts. |
+| `imageName` | String | Docker image name including repository and tag (e.g., `nginx:latest`). |
+| `name` | String | Name for the resource. Must be unique within your account. |
+| `dockerArgs` | String | Overrides the container's default start command. If not specified, uses the image's CMD. |
+| `env` | Array | Environment variables as key-value pairs (e.g., `[{key: "VAR", value: "value"}]`). |
+| `ports` | String | Ports to expose, formatted as `port/protocol` (e.g., `8888/http,22/tcp`). |
+| `gpuTypeId` | String | GPU type identifier (e.g., `NVIDIA RTX A6000`). Use the `gpuTypes` query to list available options. |
+| `gpuCount` | Integer | Number of GPUs to allocate. |
+| `containerRegistryAuthId` | String | ID of saved registry credentials for private container images. Find this in your [Runpod settings](https://www.runpod.io/console/user/settings). |