Merge branch 'master' into korean-landing

Author: jina-yoon

contents/docs/error-tracking/_snippets/cli/authenticate.mdx

@@ -11,8 +11,8 @@ If you are using the CLI in a CI/CD environment such as GitHub Actions, you can
 | Environment Variable | Description | Source |
 | --- | --- | --- |
 | `POSTHOG_CLI_HOST` | The PostHog host to connect to [default: https://us.posthog.com] | [Project settings](https://app.posthog.com/settings/project#variables) |
-| `POSTHOG_CLI_ENV_ID` | PostHog project ID | [Project settings](https://app.posthog.com/settings/project#variables) |
-| `POSTHOG_CLI_TOKEN` | **Personal API key** with `error tracking write` and `organization read` scopes | [API key settings](https://app.posthog.com/settings/user-api-keys#variables) |
+| `POSTHOG_CLI_PROJECT_ID` | PostHog project ID | [Project settings](https://app.posthog.com/settings/project#variables) |
+| `POSTHOG_CLI_API_KEY` | **Personal API key** with `error tracking write` and `organization read` scopes | [API key settings](https://app.posthog.com/settings/user-api-keys#variables) |
 
 </div>
 

contents/docs/error-tracking/_snippets/cli/inject.mdx

@@ -1,6 +1,4 @@
 ```bash
 # Inject release and chunk metadata into sourcemaps
-posthog-cli sourcemap inject --directory ./path/to/assets --project my-app --version 1.2.3
+posthog-cli sourcemap inject --directory ./path/to/assets
 ```
-
-The CLI will create or reuse the [release](/docs/error-tracking/releases) for the detected or supplied project and version. The CLI will try to detect project and version information, but you can set them explicitly with `--project` and `--version`. We recommend setting the project, and letting the CLI detect the version, if your project is continuously deployed (the version will be the git commit hash at build time).

contents/docs/error-tracking/_snippets/cli/upload.mdx

@@ -1,8 +1,8 @@
 ```bash
 # Upload injected sourcemaps to their release
-posthog-cli sourcemap upload --directory ./path/to/assets
+posthog-cli sourcemap upload --directory ./path/to/assets --release-name my-app --release-version 1.2.3
 ```
 
-The CLI reuses the release stored during injection, so you don't need to pass `--project` or `--version` again.
+The CLI will create or reuse the [release](/docs/error-tracking/releases) for the detected or supplied release name and version. The CLI will try to detect release name and version information, but you can set them explicitly with `--release-name` and `--release-version`. We recommend setting the release name, and letting the CLI detect the version, if your project is continuously deployed (the version will be the git commit hash at build time).
 
 > **💡 Tip:** You can use `--delete-after` option to clean up sourcemaps after uploading them.

contents/docs/error-tracking/_snippets/nextjs-upload-source-maps.mdx

@@ -18,12 +18,12 @@ const nextConfig = {
 
 export default withPostHogConfig(nextConfig, {
   personalApiKey: process.env.POSTHOG_API_KEY, // Personal API Key
-  envId: process.env.POSTHOG_ENV_ID, // Environment ID
+  projectId: process.env.POSTHOG_PROJECT_ID, // Project ID
   host: process.env.NEXT_PUBLIC_POSTHOG_HOST, // (optional), defaults to https://us.posthog.com
   sourcemaps: { // (optional)
       enabled: true, // (optional) Enable sourcemaps generation and upload, default to true on production builds
-      project: "my-application", // (optional) Project name, defaults to repository name
-      version: "1.0.0", // (optional) Release version, defaults to current git commit
+      releaseName: "my-application", // (optional) Release name, defaults to repository name
+      releaseVersion: "1.0.0", // (optional) Release version, defaults to current git commit
       deleteAfterUpload: true, // (optional) Delete sourcemaps after upload, defaults to true
   },
 });
@@ -35,7 +35,7 @@ Where you should set the following environment variables:
 | Environment Variable | Description |
 | --- | --- |
 | `POSTHOG_API_KEY` | [Personal API key](https://app.posthog.com/settings/user-api-keys#variables) with at least `write` access on `error tracking` |
-| `POSTHOG_ENV_ID` | Project ID you can find in your [project settings](https://app.posthog.com/settings/environment#variables) |
+| `POSTHOG_PROJECT_ID` | Project ID you can find in your [project settings](https://app.posthog.com/settings/project#variables) |
 | `NEXT_PUBLIC_POSTHOG_HOST` | Your PostHog instance URL. Defaults to `https://us.posthog.com` |
 
 ### That's it!

contents/docs/error-tracking/installation/_snippets/error-tracking-nextjs-installation-wrapper.tsx

@@ -7,9 +7,7 @@ import { addNextStepsStep } from './shared-helpers'
 export const ErrorTrackingNextJSInstallationWrapper = () => {
     return (
         <OnboardingContentWrapper snippets={{ JSEventCapture }}>
-            <NextJSInstallation
-                modifySteps={(steps) => addNextStepsStep(steps).filter((s) => s.title !== 'Upload source maps')}
-            />
+            <NextJSInstallation modifySteps={addNextStepsStep} />
         </OnboardingContentWrapper>
     )
 }

contents/docs/error-tracking/releases.mdx

@@ -17,9 +17,9 @@ Error tracking displays this release info over stack traces to help you track do
 
 ## Creating releases
 
-Release information is automatically created when you [inject sourcemaps](/docs/error-tracking/upload-source-maps/) using `posthog-cli sourcemap inject`. If you use frameworks with a PostHog package like [Next.js](/docs/error-tracking/upload-source-maps/nextjs) or [Nuxt](/docs/error-tracking/upload-source-maps/nuxt), this is handled for you. 
+Release information is automatically created when you [upload sourcemaps](/docs/error-tracking/upload-source-maps/) using `posthog-cli sourcemap upload`. If you use frameworks with a PostHog package like [Next.js](/docs/error-tracking/upload-source-maps/nextjs) or [Nuxt](/docs/error-tracking/upload-source-maps/nuxt), this is handled for you. 
 
-The CLI finds or creates the release for the project and version it detects, and stores that link inside each sourcemap. You can specify `--project` and `--version` yourself; otherwise the CLI inspects Git metadata (like the repo name and commit SHA) to choose sensible values. Artefacts are locked to their release once written, so they cannot move between releases later.
+The CLI finds or creates the release for the project and version it detects, and stores that link inside each sourcemap. You can specify `--release-name` and `--release-version` yourself; otherwise the CLI inspects Git metadata (like the repo name and commit SHA) to choose sensible values. Artefacts are locked to their release once written, so they cannot move between releases later.
 
 ## Uploading artefacts
 

contents/docs/error-tracking/upload-source-maps/github-actions.mdx

@@ -36,14 +36,14 @@ jobs:
 
       # Inject and upload source maps using the PostHog action
       - name: Inject & upload source maps to PostHog
-        uses: PostHog/upload-source-maps@v0.4.6
+        uses: PostHog/upload-source-maps@v2
         with:
           directory: dist
-          env-id: ${{ secrets.POSTHOG_ENV_ID }}
-          cli-token: ${{ secrets.POSTHOG_CLI_TOKEN }}
+          project-id: ${{ secrets.POSTHOG_PROJECT_ID }}
+          api-key: ${{ secrets.POSTHOG_CLI_API_KEY }}
           # host: https://eu.posthog.com # Required only for EU cloud
-          # project: my-awesome-project  # Optional; falls back to repo name
-          # version: ${{ github.sha }}   # Optional; falls back to current commit SHA
+          # release-name: my-awesome-project  # Optional; falls back to repo name
+          # release-version: ${{ github.sha }}   # Optional; falls back to current commit SHA
 ```
 
 This step:
@@ -61,15 +61,15 @@ This step:
 | **Name** | **Required** | **Description** |
 | --- | --- | --- |
 | `directory` | Yes | Directory containing built assets (for example, `dist`) |
-| `env-id` | Yes | PostHog project ID. Get it from your [project settings](https://app.posthog.com/settings/environment#variables) |
-| `cli-token` | Yes | Personal API key with error tracking write and organization read scopes. Get it from your [personal API key settings](https://app.posthog.com/settings/user-api-keys#variables) |
-| `project` | No | Project identifier. Defaults to the Git repository name when available |
-| `version` | No | Release/version (for example, commit SHA). Defaults to current commit SHA when available |
+| `project-id` | Yes | PostHog project ID. Get it from your [project settings](https://app.posthog.com/settings/project#variables) |
+| `api-key` | Yes | Personal API key with error tracking write and organization read scopes. Get it from your [personal API key settings](https://app.posthog.com/settings/user-api-keys#variables) |
+| `release-name` | No | Release name. Defaults to the Git repository name when available |
+| `release-version` | No | Release version (for example, commit SHA). Defaults to current commit SHA when available |
 | `host` | No | PostHog host URL. Defaults to `https://us.posthog.com`. For EU cloud, set it to `https://eu.posthog.com` |
 
 </div>
 
-We recommend storing `env-id` and `cli-token` in GitHub Secrets (for example, `POSTHOG_ENV_ID` and `POSTHOG_CLI_TOKEN`).
+We recommend storing `project-id` and `api-key` in GitHub Secrets (for example, `POSTHOG_PROJECT_ID` and `POSTHOG_CLI_API_KEY`).
 
 </Step>
 

contents/docs/error-tracking/upload-source-maps/nextjs.mdx

@@ -25,12 +25,12 @@ showStepsToc: true
 
   export default withPostHogConfig(nextConfig, {
     personalApiKey: process.env.POSTHOG_API_KEY, // Personal API Key
-    envId: process.env.POSTHOG_ENV_ID, // Environment ID
+    projectId: process.env.POSTHOG_PROJECT_ID, // Project ID
     host: process.env.NEXT_PUBLIC_POSTHOG_HOST, // (optional), defaults to https://us.posthog.com
     sourcemaps: { // (optional)
         enabled: true, // (optional) Enable sourcemaps generation and upload, default to true on production builds
-        project: "my-application", // (optional) Project name, defaults to repository name
-        version: "1.0.0", // (optional) Release version, defaults to current git commit
+        releaseName: "my-application", // (optional) Release name, defaults to repository name
+        releaseVersion: "1.0.0", // (optional) Release version, defaults to current git commit
         deleteAfterUpload: true, // (optional) Delete sourcemaps after upload, defaults to true
     },
   });
@@ -44,7 +44,7 @@ showStepsToc: true
   | Environment Variable | Description |
   | --- | --- |
   | `POSTHOG_API_KEY` | [Personal API key](https://app.posthog.com/settings/user-api-keys#variables) with at least `write` access on `error tracking` |
-  | `POSTHOG_ENV_ID` | Project ID you can find in your [project settings](https://app.posthog.com/settings/environment#variables) |
+  | `POSTHOG_PROJECT_ID` | Project ID you can find in your [project settings](https://app.posthog.com/settings/project#variables) |
   | `NEXT_PUBLIC_POSTHOG_HOST` | Your PostHog instance URL. Defaults to `https://us.posthog.com` |
 
   </div>

contents/docs/error-tracking/upload-source-maps/rollup.mdx

@@ -27,12 +27,12 @@ showStepsToc: true
     plugins: [
       posthog({
         personalApiKey: process.env.POSTHOG_API_KEY, // Personal API Key
-        envId: process.env.POSTHOG_ENV_ID, // Environment ID
+        projectId: process.env.POSTHOG_PROJECT_ID, // Project ID
         host: process.env.POSTHOG_HOST, // (optional) defaults to https://us.i.posthog.com
         sourcemaps: { // (optional)
           enabled: true, // (optional) Enable sourcemaps generation and upload, defaults to true
-          project: 'my-application', // (optional) Project name
-          version: '1.0.0', // (optional) Release version
+          releaseName: 'my-application', // (optional) Release name
+          releaseVersion: '1.0.0', // (optional) Release version
           deleteAfterUpload: true, // (optional) Delete sourcemaps after upload, defaults to true
         },
       }),
@@ -47,7 +47,7 @@ showStepsToc: true
   | Environment Variable | Description |
   | --- | --- |
   | `POSTHOG_API_KEY` | [Personal API key](https://app.posthog.com/settings/user-api-keys#variables) with at least `write` access on `error tracking` |
-  | `POSTHOG_ENV_ID` | Project ID you can find in your [project settings](https://app.posthog.com/settings/environment#variables) |
+  | `POSTHOG_PROJECT_ID` | Project ID you can find in your [project settings](https://app.posthog.com/settings/project#variables) |
   | `POSTHOG_HOST` | (optional) Your PostHog instance URL. Defaults to `https://us.i.posthog.com` |
 
   </div>

contents/docs/error-tracking/upload-source-maps/vite.mdx

@@ -27,12 +27,12 @@ showStepsToc: true
     plugins: [
       posthog({
         personalApiKey: process.env.POSTHOG_API_KEY, // Personal API Key
-        envId: process.env.POSTHOG_ENV_ID, // Environment ID
+        projectId: process.env.POSTHOG_PROJECT_ID, // Project ID
         host: process.env.POSTHOG_HOST, // (optional) defaults to https://us.i.posthog.com
         sourcemaps: { // (optional)
           enabled: true, // (optional) Enable sourcemaps generation and upload, defaults to true
-          project: 'my-application', // (optional) Project name
-          version: '1.0.0', // (optional) Release version
+          releaseName: 'my-application', // (optional) Release name
+          releaseVersion: '1.0.0', // (optional) Release version
           deleteAfterUpload: true, // (optional) Delete sourcemaps after upload, defaults to true
         },
       }),
@@ -47,7 +47,7 @@ showStepsToc: true
   | Environment variable | Description |
   | --- | --- |
   | `POSTHOG_API_KEY` | [Personal API key](https://app.posthog.com/settings/user-api-keys#variables) with at least `write` access on `error tracking` |
-  | `POSTHOG_ENV_ID` | Project ID you can find in your [project settings](https://app.posthog.com/settings/environment#variables) |
+  | `POSTHOG_PROJECT_ID` | Project ID you can find in your [project settings](https://app.posthog.com/settings/project#variables) |
   | `POSTHOG_HOST` | (optional) Your PostHog instance URL. Defaults to `https://us.i.posthog.com` |
 
   </div>