From 31f96a01f16b341262a30025fce87a464316f7b8 Mon Sep 17 00:00:00 2001
From: Boshen <boshenc@gmail.com>
Date: Thu, 13 Nov 2025 15:03:57 +0800
Subject: [PATCH 01/36] Add Type-Aware Linting Alpha blog post
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .vitepress/config/inlined-scripts/banner.js |  2 +-
 .vitepress/sidebar.blog.json                |  4 +-
 .vitepress/theme/components/Banner.vue      |  4 +-
 src/blog/2025-12-01-type-aware-alpha.md     | 41 +++++++++++++++++++++
 4 files changed, 46 insertions(+), 5 deletions(-)
 create mode 100644 src/blog/2025-12-01-type-aware-alpha.md

diff --git a/.vitepress/config/inlined-scripts/banner.js b/.vitepress/config/inlined-scripts/banner.js
index 72f8f1ac523..c2d5f7e8143 100644
--- a/.vitepress/config/inlined-scripts/banner.js
+++ b/.vitepress/config/inlined-scripts/banner.js
@@ -6,6 +6,6 @@
     }
   };
 
-  window.__OXC_BANNER_ID__ = "/blog/2025-12-01-oxfmt-alpha";
+  window.__OXC_BANNER_ID__ = "/blog/2025-12-01-type-aware-alpha";
   restore(`oxc-banner-dismissed-${__OXC_BANNER_ID__}`, "banner-dismissed");
 })();
diff --git a/.vitepress/sidebar.blog.json b/.vitepress/sidebar.blog.json
index 083020d4388..70ed5dc136c 100644
--- a/.vitepress/sidebar.blog.json
+++ b/.vitepress/sidebar.blog.json
@@ -1,7 +1,7 @@
 [
   {
-    "text": "Oxfmt Alpha",
-    "link": "/blog/2025-12-01-oxfmt-alpha"
+    "text": "Type-Aware Linting Alpha",
+    "link": "/blog/2025-12-01-type-aware-alpha"
   },
   {
     "text": "Oxlint JS Plugins Preview",
diff --git a/.vitepress/theme/components/Banner.vue b/.vitepress/theme/components/Banner.vue
index 26b4a89dca0..9c8023366a1 100644
--- a/.vitepress/theme/components/Banner.vue
+++ b/.vitepress/theme/components/Banner.vue
@@ -17,7 +17,7 @@ const hide = () => {
 };
 
 // Sync with inlined-scripts/banner.js
-const slug = "/blog/2025-12-01-oxfmt-alpha";
+const slug = "/blog/2025-12-01-type-aware-alpha";
 
 const bannerDismissed = useLocalStorage<boolean>(`oxc-banner-dismissed-${slug}`, false);
 
@@ -46,7 +46,7 @@ const dismiss = () => {
 
 <template>
   <div ref="el" class="banner banner-dismissed">
-    <div class="text"><a :href="slug">Oxfmt: Announcing Oxc Formatter Alpha</a> 🎉</div>
+    <div class="text"><a :href="slug">Announcing Type-Aware Linting Alpha</a> 🎉</div>
 
     <button type="button" @click="dismiss">
       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor">
diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
new file mode 100644
index 00000000000..18b35e832e4
--- /dev/null
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -0,0 +1,41 @@
+---
+title: Type-Aware Linting Alpha
+outline: deep
+authors:
+  - cameron
+  - camchenry
+---
+
+<AppBlogPostHeader />
+
+<br>
+
+We're excited to announce the alpha release of type-aware linting in Oxlint!
+
+## Overview
+
+[Add overview content here]
+
+## Quick Start
+
+[Add quick start instructions here]
+
+## What's New
+
+[Add details about new features and capabilities]
+
+## Performance
+
+[Add performance benchmarks and comparisons]
+
+## Technical Details
+
+[Add technical implementation details]
+
+## What's Next
+
+[Add roadmap and future plans]
+
+## Try It Out
+
+[Add call to action and community information]

From 9b8b78edc0c37cdd0fbf6d3372270d3921501144 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Sat, 15 Nov 2025 11:25:50 +0000
Subject: [PATCH 02/36] first pass

---
 src/blog/2025-12-01-type-aware-alpha.md | 83 ++++++++++++++++++++++++-
 1 file changed, 80 insertions(+), 3 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 18b35e832e4..4ff828e3ab6 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -14,11 +14,54 @@ We're excited to announce the alpha release of type-aware linting in Oxlint!
 
 ## Overview
 
-[Add overview content here]
+Following our [technical preview in August](/blog/2025-08-17-oxlint-type-aware), we're excited to announce that type-aware linting has reached alpha status. This milestone brings significant improvements in stability, configurability, and rule coverage.
+
+Type-aware linting enables powerful rules like `no-floating-promises`, `no-misused-promises`, and `await-thenable` that catch bugs by understanding TypeScript's type system. With N type-aware rules now available, you can catch entire categories of runtime errors before they happen.
+
+The alpha release addresses the major limitations from the technical preview:
+
+- **Full rule configuration support** - Configure individual type-aware rules in `.oxlintrc.json`
+- **Disable comment support** - Use `eslint-disable` comments to control type-aware rules
+- **IDE support** - Type-aware linting works in VSCode and other supported editors
+- **Improved stability** - Many crashes and edge cases have been fixed
+
+While we're still working on performance for very large monorepos and some advanced rules, the alpha is ready for testing in production codebases.
 
 ## Quick Start
 
-[Add quick start instructions here]
+Install `oxlint` and `oxlint-tsgolint`, then run with the `--type-aware` flag:
+
+::: code-group
+
+```sh [npm]
+npm add -D oxlint oxlint-tsgolint@latest
+npx oxlint --type-aware
+```
+
+```sh [pnpm]
+pnpm add -D oxlint oxlint-tsgolint@latest
+pnpm oxlint --type-aware
+```
+
+```sh [yarn]
+yarn add -D oxlint oxlint-tsgolint@latest
+yarn oxlint --type-aware
+```
+
+```sh [bun]
+bun add -D oxlint oxlint-tsgolint@latest
+bunx oxlint --type-aware
+```
+
+:::
+
+To try a specific type-aware rule without other configuration:
+
+```bash
+npx oxlint --type-aware -A all -D typescript/no-floating-promises
+```
+
+For more configuration options, see our [usage guide](/docs/guide/usage/linter/type-aware).
 
 ## What's New
 
@@ -30,7 +73,41 @@ We're excited to announce the alpha release of type-aware linting in Oxlint!
 
 ## Technical Details
 
-[Add technical implementation details]
+### Architecture
+
+Type-aware linting in Oxlint uses a unique two-binary architecture:
+
+```
+oxlint CLI (Rust)
+  ├─ Handles file traversal, ignore logic, and diagnostics
+  ├─ Passes paths and configuration to tsgolint
+  └─ Formats and displays results
+
+tsgolint (Go)
+  ├─ Uses typescript-go for type checking
+  ├─ Executes type-aware rules
+  └─ Returns structured diagnostics
+```
+
+This design keeps Oxlint's core fast while leveraging TypeScript's type system through typescript-go. The frontend-backend separation means `oxlint` controls the user experience while `tsgolint` handles the heavy lifting of type analysis.
+
+### TypeScript Compatibility
+
+`tsgolint` is based on [typescript-go](https://github.com/microsoft/typescript-go), Microsoft's TypeScript v7.0 rewrite in Go, not the original TypeScript compiler.
+
+**Important compatibility notes:**
+
+- Only TypeScript 7.0+ features are supported
+- Pre-7.0 syntax and deprecated features are not supported
+- Legacy `tsconfig.json` options like `baseUrl` have been removed in TypeScript 7.0
+
+If you're using deprecated features from TypeScript 6.0 or earlier, you'll need to migrate your codebase first. See the [TypeScript migration guide](https://github.com/microsoft/TypeScript/issues/62508#issuecomment-3348649259) for help updating deprecated tsconfig options.
+
+### Implementation Details
+
+`tsgolint` doesn't use typescript-go's public APIs. Instead, it compiles typescript-go by [shimming](https://github.com/oxc-project/tsgolint/tree/main/shim) internal APIs to make them accessible. We actively track typescript-go updates and fix breaking changes as needed.
+
+Our typescript-go fork is synced regularly using renovatebot, ensuring we stay current with the latest improvements and fixes.
 
 ## What's Next
 

From 36cc3d5cfbe05bb2bf789c9f02cf14d9fdb591d8 Mon Sep 17 00:00:00 2001
From: Cam McHenry <camchenry@users.noreply.github.com>
Date: Sat, 15 Nov 2025 14:41:37 -0500
Subject: [PATCH 03/36] Add features

Added new features and capabilities for rule configuration and diagnostics in oxlint.

Signed-off-by: Cam McHenry <camchenry@users.noreply.github.com>
---
 src/blog/2025-12-01-type-aware-alpha.md | 65 ++++++++++++++++++++++++-
 1 file changed, 64 insertions(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 4ff828e3ab6..0450365080c 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -65,7 +65,70 @@ For more configuration options, see our [usage guide](/docs/guide/usage/linter/t
 
 ## What's New
 
-[Add details about new features and capabilities]
+### Rule configuration support in `oxlint`
+
+Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like any other lint rule. For example, you can configure the `no-floating-promises` rule to allow certain safe calls or ignore `void`:
+
+```json
+{
+  "rules": {
+    "typescript/no-floating-promises": ["error", {
+      "ignoreVoid": true,
+      "allowForKnownSafePromises": [
+        { "from": "file", "name": "SafePromise" },
+        { "from": "lib", "name": "PromiseLike" },
+      ]
+    }]
+  }
+}
+```
+
+Previously, this would silently fail, but now the configuration is actually passed to `tsgolint` and parsed for the lint rule to use.
+
+### Disable comment support in `oxlint`
+
+Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` rule by placing a comment in the file or on a line:
+
+```js
+// oxlint-disable-next-line typescript/no-floating-promises
+
+/* oxlint-disable-file typescript/no-floating-promises
+```
+
+Previously, this didn't actually disable the rule, but now it will.
+
+### More supported rules
+
+The alpha milestone is largely focused on stability and integrating `tsgolint` more closely with `oxlint`, but we've still ported several rules from `typescript-eslint` which you can now use via `oxlint` as well: 
+
+- `no-deprecated`
+- `prefer-includes`
+- `strict-boolean-expressions`
+
+### TypeScript program diagnostics are now reported
+
+Previously, if TypeScript failed to create and parse a program, these errors were not reported which lead to confusion around why linting was not working. Now, we report any issues with creating a program as a diagnostic. For example, if a `tsconfig.json` file contains `baseUrl`, that will be reported now:
+
+```
+$ oxlint --type-aware
+
+  × Invalid tsconfig
+   ╭─[docs/tsconfig.json:1:1]
+ 1 │ {
+   · ▲
+ 2 │   "compilerOptions": {
+   ╰────
+  help: Non-relative paths are not allowed. Did you forget a leading './'?
+
+  × Invalid tsconfig
+   ╭─[test/ui/tsconfig.json:1:1]
+ 1 │ {
+   · ▲
+ 2 │   "extends": "../../tsconfig.base.json",
+   ╰────
+  help: Option 'baseUrl' has been removed. Please remove it from your configuration.
+        See https://github.com/oxc-project/tsgolint/issues/351 for more information.
+```
 
 ## Performance
 

From f699974099f016b35318cb1a17721c426da284de Mon Sep 17 00:00:00 2001
From: Cam McHenry <camchenry@users.noreply.github.com>
Date: Sat, 15 Nov 2025 14:44:01 -0500
Subject: [PATCH 04/36] Fix code block

Signed-off-by: Cam McHenry <camchenry@users.noreply.github.com>
---
 src/blog/2025-12-01-type-aware-alpha.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 0450365080c..a65f513ee77 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -89,10 +89,11 @@ Previously, this would silently fail, but now the configuration is actually pass
 
 Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` rule by placing a comment in the file or on a line:
 
-```js
-// oxlint-disable-next-line typescript/no-floating-promises
+```ts
+/* oxlint-disable typescript/no-floating-promises */
 
-/* oxlint-disable-file typescript/no-floating-promises
+// oxlint-disable-next-line typescript/no-floating-promises
+[1, 2, 3].map(async x => x + 1);
 ```
 
 Previously, this didn't actually disable the rule, but now it will.

From cf4d567823dc85b4b6403b8f5fac89ec89c517ee Mon Sep 17 00:00:00 2001
From: Cam McHenry <camchenry@users.noreply.github.com>
Date: Mon, 1 Dec 2025 23:29:26 -0500
Subject: [PATCH 05/36] Update post

Signed-off-by: Cam McHenry <camchenry@users.noreply.github.com>
---
 src/blog/2025-12-01-type-aware-alpha.md | 74 +++++++++++++++++--------
 1 file changed, 51 insertions(+), 23 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index a65f513ee77..48d6b9e09e7 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -16,7 +16,7 @@ We're excited to announce the alpha release of type-aware linting in Oxlint!
 
 Following our [technical preview in August](/blog/2025-08-17-oxlint-type-aware), we're excited to announce that type-aware linting has reached alpha status. This milestone brings significant improvements in stability, configurability, and rule coverage.
 
-Type-aware linting enables powerful rules like `no-floating-promises`, `no-misused-promises`, and `await-thenable` that catch bugs by understanding TypeScript's type system. With N type-aware rules now available, you can catch entire categories of runtime errors before they happen.
+Type-aware linting enables powerful rules like `no-floating-promises`, `no-misused-promises`, and `await-thenable` that catch bugs by utilizing TypeScript's type system. With 43 type-aware rules now available, you can catch entire categories of runtime errors before they happen.
 
 The alpha release addresses the major limitations from the technical preview:
 
@@ -24,6 +24,7 @@ The alpha release addresses the major limitations from the technical preview:
 - **Disable comment support** - Use `eslint-disable` comments to control type-aware rules
 - **IDE support** - Type-aware linting works in VSCode and other supported editors
 - **Improved stability** - Many crashes and edge cases have been fixed
+- **Better performance** - Less memory used and slightly better rule performance in some cases
 
 While we're still working on performance for very large monorepos and some advanced rules, the alpha is ready for testing in production codebases.
 
@@ -55,16 +56,44 @@ bunx oxlint --type-aware
 
 :::
 
-To try a specific type-aware rule without other configuration:
+To try a specific type-aware rule without other configuration (`tsgolint` must be installed globally or locally already):
 
-```bash
+::: code-group
+
+```sh [npm]
 npx oxlint --type-aware -A all -D typescript/no-floating-promises
 ```
 
+```sh [pnpm]
+pnpx oxlint --type-aware -A all -D typescript/no-floating-promises
+```
+
+```sh [bun]
+bunx oxlint --type-aware -A all -D typescript/no-floating-promises
+```
+
+:::
+
 For more configuration options, see our [usage guide](/docs/guide/usage/linter/type-aware).
 
 ## What's New
 
+### Support for type-checking while linting
+
+`tsgolint` now supports emitting type checking errors from TypeScript while linting. Since type-aware rules already require checking all of the types within a file, we are able to use this existing type information rather than discarding it. This means that in some cases, it is possible to skip doing a separate type-check command altogether (e.g., `tsc --noEmit`), reducing total time spent doing linting and type-checking in CI.
+
+This is an experimental feature, but you can enable it by adding the `--type-check` and `--type-aware` flag to the `oxlint` command:
+
+```
+$ oxlint --type-aware --type-check
+
+  × typescript(TS2322): Type 'number' is not assignable to type 'string'.
+   ╭─[index.ts:1:7]
+ 1 │ const message: string = 1
+   ·       ───────
+   ╰────
+```
+
 ### Rule configuration support in `oxlint`
 
 Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like any other lint rule. For example, you can configure the `no-floating-promises` rule to allow certain safe calls or ignore `void`:
@@ -83,7 +112,9 @@ Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like
 }
 ```
 
-Previously, this would silently fail, but now the configuration is actually passed to `tsgolint` and parsed for the lint rule to use.
+The configuration options are aligned with what `typescript-eslint` supports and documentation can be found in the configuration section for each rule (like [`no-floating-promises`](https://oxc.rs/docs/guide/usage/linter/rules/typescript/no-floating-promises.html#configuration)).
+
+Previously, configuring this rule would silently fail, but now the configuration is actually passed to `tsgolint` and parsed for the lint rule to use.
 
 ### Disable comment support in `oxlint`
 
@@ -96,36 +127,33 @@ Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` r
 [1, 2, 3].map(async x => x + 1);
 ```
 
-Previously, this didn't actually disable the rule, but now it will.
+Previously, this didn't actually disable the rule, but now it will work as expected.
 
 ### More supported rules
 
-The alpha milestone is largely focused on stability and integrating `tsgolint` more closely with `oxlint`, but we've still ported several rules from `typescript-eslint` which you can now use via `oxlint` as well: 
+We've continued to make progress on porting popular rules from `typescript-eslint` which you can now use via `oxlint`. `tsgolint`, combined with `oxlint`, currently supports 43 type-aware rules.
+
+Since the initial preview, support for the following rules has also been added:
 
-- `no-deprecated`
+- `no-deprecated` (one of the most commonly requested rules)
 - `prefer-includes`
 - `strict-boolean-expressions`
 
 ### TypeScript program diagnostics are now reported
 
-Previously, if TypeScript failed to create and parse a program, these errors were not reported which lead to confusion around why linting was not working. Now, we report any issues with creating a program as a diagnostic. For example, if a `tsconfig.json` file contains `baseUrl`, that will be reported now:
+Previously, if TypeScript failed to create and parse a program, these errors were not reported which lead to confusion around why linting was not working. Now, we report any issues with creating a program as a diagnostic, including if there is a configuration issue in the `tsconfig.json` file. 
+
+For example, if a `tsconfig.json` file contains `baseUrl`, that will be reported as an error, since `baseUrl` has been removed from TypeScript:
 
 ```
 $ oxlint --type-aware
 
-  × Invalid tsconfig
-   ╭─[docs/tsconfig.json:1:1]
- 1 │ {
-   · ▲
- 2 │   "compilerOptions": {
-   ╰────
-  help: Non-relative paths are not allowed. Did you forget a leading './'?
-
-  × Invalid tsconfig
-   ╭─[test/ui/tsconfig.json:1:1]
- 1 │ {
-   · ▲
- 2 │   "extends": "../../tsconfig.base.json",
+  × typescript(tsconfig-error): Invalid tsconfig
+   ╭─[tsconfig.json:4:3]
+ 3 │     "compilerOptions": {
+ 4 │         "baseUrl": ".",
+   ·         ─────────
+ 5 │         "experimentalDecorators": true,
    ╰────
   help: Option 'baseUrl' has been removed. Please remove it from your configuration.
         See https://github.com/oxc-project/tsgolint/issues/351 for more information.
@@ -148,7 +176,7 @@ oxlint CLI (Rust)
   └─ Formats and displays results
 
 tsgolint (Go)
-  ├─ Uses typescript-go for type checking
+  ├─ Uses typescript-go directly for type checking
   ├─ Executes type-aware rules
   └─ Returns structured diagnostics
 ```
@@ -157,7 +185,7 @@ This design keeps Oxlint's core fast while leveraging TypeScript's type system t
 
 ### TypeScript Compatibility
 
-`tsgolint` is based on [typescript-go](https://github.com/microsoft/typescript-go), Microsoft's TypeScript v7.0 rewrite in Go, not the original TypeScript compiler.
+`tsgolint` is based on [typescript-go](https://github.com/microsoft/typescript-go), Microsoft's TypeScript v7.0 rewrite in Go, not the original TypeScript compiler. This means that you encounter some features which are no longer supported.
 
 **Important compatibility notes:**
 

From 730d39918dd04e7c5716b0541aa8e6b5f6bcc661 Mon Sep 17 00:00:00 2001
From: Cam McHenry <camchenry@users.noreply.github.com>
Date: Mon, 1 Dec 2025 23:32:31 -0500
Subject: [PATCH 06/36] Fix minor wording and formatting issues in blog post

Signed-off-by: Cam McHenry <camchenry@users.noreply.github.com>
---
 src/blog/2025-12-01-type-aware-alpha.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 48d6b9e09e7..94ebf2d387c 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -105,7 +105,7 @@ Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like
       "ignoreVoid": true,
       "allowForKnownSafePromises": [
         { "from": "file", "name": "SafePromise" },
-        { "from": "lib", "name": "PromiseLike" },
+        { "from": "lib", "name": "PromiseLike" }
       ]
     }]
   }
@@ -185,7 +185,7 @@ This design keeps Oxlint's core fast while leveraging TypeScript's type system t
 
 ### TypeScript Compatibility
 
-`tsgolint` is based on [typescript-go](https://github.com/microsoft/typescript-go), Microsoft's TypeScript v7.0 rewrite in Go, not the original TypeScript compiler. This means that you encounter some features which are no longer supported.
+`tsgolint` is based on [typescript-go](https://github.com/microsoft/typescript-go), Microsoft's TypeScript v7.0 rewrite in Go, not the original TypeScript compiler. This means that you might encounter some features which are no longer supported.
 
 **Important compatibility notes:**
 

From a4c096cf473d9c068e9e0a5210e416f1ca883bb3 Mon Sep 17 00:00:00 2001
From: Cam McHenry <camchenry@users.noreply.github.com>
Date: Tue, 2 Dec 2025 08:54:54 -0500
Subject: [PATCH 07/36] Add known issues

Signed-off-by: Cam McHenry <camchenry@users.noreply.github.com>
---
 src/blog/2025-12-01-type-aware-alpha.md | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 94ebf2d387c..ed21a6a6831 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -76,7 +76,7 @@ bunx oxlint --type-aware -A all -D typescript/no-floating-promises
 
 For more configuration options, see our [usage guide](/docs/guide/usage/linter/type-aware).
 
-## What's New
+## What's new
 
 ### Support for type-checking while linting
 
@@ -163,7 +163,7 @@ $ oxlint --type-aware
 
 [Add performance benchmarks and comparisons]
 
-## Technical Details
+## Technical details
 
 ### Architecture
 
@@ -183,7 +183,7 @@ tsgolint (Go)
 
 This design keeps Oxlint's core fast while leveraging TypeScript's type system through typescript-go. The frontend-backend separation means `oxlint` controls the user experience while `tsgolint` handles the heavy lifting of type analysis.
 
-### TypeScript Compatibility
+### TypeScript compatibility
 
 `tsgolint` is based on [typescript-go](https://github.com/microsoft/typescript-go), Microsoft's TypeScript v7.0 rewrite in Go, not the original TypeScript compiler. This means that you might encounter some features which are no longer supported.
 
@@ -195,16 +195,20 @@ This design keeps Oxlint's core fast while leveraging TypeScript's type system t
 
 If you're using deprecated features from TypeScript 6.0 or earlier, you'll need to migrate your codebase first. See the [TypeScript migration guide](https://github.com/microsoft/TypeScript/issues/62508#issuecomment-3348649259) for help updating deprecated tsconfig options.
 
-### Implementation Details
+### Implementation details
 
 `tsgolint` doesn't use typescript-go's public APIs. Instead, it compiles typescript-go by [shimming](https://github.com/oxc-project/tsgolint/tree/main/shim) internal APIs to make them accessible. We actively track typescript-go updates and fix breaking changes as needed.
 
 Our typescript-go fork is synced regularly using renovatebot, ensuring we stay current with the latest improvements and fixes.
 
-## What's Next
+### Known issues
+
+While `tsgolint` is ready for testing in production codebases, you may encounter issues with running out of memory when working with very large codebases. We are working on optimizing the memory usage for the next milestone. We would love if you tried `tsgolint` and reported any out-of-memory issues to us in the [`tsgolint` repository](https://github.com/oxc-project/tsgolint) and included some details about your project to help us improve memory usage.
+
+## What's next
 
 [Add roadmap and future plans]
 
-## Try It Out
+## Try it out
 
 [Add call to action and community information]

From 544ea8a961bdac1f6a56ffe2a5188ddf8febb11e Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:17:34 +0000
Subject: [PATCH 08/36] adds whats next and try it out section

---
 src/blog/2025-12-01-type-aware-alpha.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index ed21a6a6831..61d0ba53d25 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -207,8 +207,18 @@ While `tsgolint` is ready for testing in production codebases, you may encounter
 
 ## What's next
 
-[Add roadmap and future plans]
+We're actively working on the following improvements for the beta release:
+
+- **More supported rules** - Currently we support 43 out the 59 type-aware rules from `typescript-eslint`. As we head towards a beta release, we plan to continue expanding rule coverage.
+- **Performance and memory usage improvements** - We're going to continue to optimize performance, especially for very large monorepos.
 
 ## Try it out
 
-[Add call to action and community information]
+Install `oxlint` and `oxlint-tsgolint`, then run with the `--type-aware` flag:
+
+```sh
+pnpm add -D oxlint oxlint-tsgolint
+pnpm oxlint --type-aware
+```
+
+We'd love to hear your feedback! If you encounter any issues, please report them in the [oxlint](https://github.com/oxc-project/oxc) or [tsgolint](https://github.com/oxc-project/tsgolint) repositories.

From 2b3aee4dfa532d956c5fc80361ff043003033195 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:23:20 +0000
Subject: [PATCH 09/36] rephrase note

---
 src/blog/2025-12-01-type-aware-alpha.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 61d0ba53d25..d71ef56cba5 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -114,7 +114,8 @@ Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like
 
 The configuration options are aligned with what `typescript-eslint` supports and documentation can be found in the configuration section for each rule (like [`no-floating-promises`](https://oxc.rs/docs/guide/usage/linter/rules/typescript/no-floating-promises.html#configuration)).
 
-Previously, configuring this rule would silently fail, but now the configuration is actually passed to `tsgolint` and parsed for the lint rule to use.
+
+In the technical preview, rule configurations were not passed to `tsgolint`, so customizing type-aware rules had no effect. Now, all configuration options are properly forwarded and applied.
 
 ### Disable comment support in `oxlint`
 

From 9d1a2c4d507b52fba38585d61e0e308a841e4e05 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:23:27 +0000
Subject: [PATCH 10/36] rephrase note

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index d71ef56cba5..2ff33c76106 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -128,7 +128,7 @@ Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` r
 [1, 2, 3].map(async x => x + 1);
 ```
 
-Previously, this didn't actually disable the rule, but now it will work as expected.
+In the technical preview, disable comments were ignored for type-aware rules. Now, they work exactly as you would expect.
 
 ### More supported rules
 

From 87ae0204329cb07d4dc31f67c5ac56a9029a1986 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:24:07 +0000
Subject: [PATCH 11/36] format code block

---
 src/blog/2025-12-01-type-aware-alpha.md | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 2ff33c76106..a40388dd150 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -101,13 +101,16 @@ Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like
 ```json
 {
   "rules": {
-    "typescript/no-floating-promises": ["error", {
-      "ignoreVoid": true,
-      "allowForKnownSafePromises": [
-        { "from": "file", "name": "SafePromise" },
-        { "from": "lib", "name": "PromiseLike" }
-      ]
-    }]
+    "typescript/no-floating-promises": [
+      "error",
+      {
+        "ignoreVoid": true,
+        "allowForKnownSafePromises": [
+          { "from": "file", "name": "SafePromise" },
+          { "from": "lib", "name": "PromiseLike" }
+        ]
+      }
+    ]
   }
 }
 ```

From 3563232ad35be83d57875020cf9c53ceac4e29ed Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:24:16 +0000
Subject: [PATCH 12/36] rephrase

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index a40388dd150..2f18964d4e1 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -145,7 +145,7 @@ Since the initial preview, support for the following rules has also been added:
 
 ### TypeScript program diagnostics are now reported
 
-Previously, if TypeScript failed to create and parse a program, these errors were not reported which lead to confusion around why linting was not working. Now, we report any issues with creating a program as a diagnostic, including if there is a configuration issue in the `tsconfig.json` file. 
+Previously, if TypeScript failed to create and parse a program, these errors were not reported which lead to confusion around why linting was not working. Now, we report any issues with creating a program as a diagnostic, including configuration issues in `tsconfig.json` files.
 
 For example, if a `tsconfig.json` file contains `baseUrl`, that will be reported as an error, since `baseUrl` has been removed from TypeScript:
 

From 8f84e80efafc79bb38e913c2567efcb04b23c0d7 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:24:28 +0000
Subject: [PATCH 13/36] add note about automated fixes

---
 src/blog/2025-12-01-type-aware-alpha.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 2f18964d4e1..5cd4da0b649 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -163,6 +163,11 @@ $ oxlint --type-aware
         See https://github.com/oxc-project/tsgolint/issues/351 for more information.
 ```
 
+
+### Automatic fixes for type-aware rules
+
+Type-aware rules now support automatic fixes via the `--fix` flag. When you run `oxlint --type-aware --fix`, fixable diagnostics from `tsgolint` are applied just like regular `oxlint` fixes. This brings full parity with non-type-aware rules for the fix workflow.
+
 ## Performance
 
 [Add performance benchmarks and comparisons]

From 7a4dd5d5fffb64aa7676563065c2758557bd11d5 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:24:44 +0000
Subject: [PATCH 14/36] add note in diagram about non type aware rules/custom
 plugins

---
 src/blog/2025-12-01-type-aware-alpha.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 5cd4da0b649..4bab7c0d6be 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -181,6 +181,7 @@ Type-aware linting in Oxlint uses a unique two-binary architecture:
 ```
 oxlint CLI (Rust)
   ├─ Handles file traversal, ignore logic, and diagnostics
+  ├─ Runs non-type-aware rules and custom JS plugins
   ├─ Passes paths and configuration to tsgolint
   └─ Formats and displays results
 

From c8fc84ef54d8574c1d65815922c488514055da47 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:24:57 +0000
Subject: [PATCH 15/36] add note about keeping up to date with tsgo

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 4bab7c0d6be..f58b86fe0af 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -209,7 +209,7 @@ If you're using deprecated features from TypeScript 6.0 or earlier, you'll need
 
 `tsgolint` doesn't use typescript-go's public APIs. Instead, it compiles typescript-go by [shimming](https://github.com/oxc-project/tsgolint/tree/main/shim) internal APIs to make them accessible. We actively track typescript-go updates and fix breaking changes as needed.
 
-Our typescript-go fork is synced regularly using renovatebot, ensuring we stay current with the latest improvements and fixes.
+Our typescript-go fork is synced regularly using renovatebot, ensuring we stay current with the latest improvements and fixes. Once TypeScript 7.0 is officially released, we will track stable releases rather than the tip of the main branch.
 
 ### Known issues
 

From deeaaec0f436f046fb8bffbf8b1c9b6b8a7c86f9 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:25:14 +0000
Subject: [PATCH 16/36] minor phrasing update, code fmt

---
 src/blog/2025-12-01-type-aware-alpha.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index f58b86fe0af..ff09051dafd 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -128,7 +128,7 @@ Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` r
 /* oxlint-disable typescript/no-floating-promises */
 
 // oxlint-disable-next-line typescript/no-floating-promises
-[1, 2, 3].map(async x => x + 1);
+[1, 2, 3].map(async (x) => x + 1);
 ```
 
 In the technical preview, disable comments were ignored for type-aware rules. Now, they work exactly as you would expect.
@@ -147,7 +147,7 @@ Since the initial preview, support for the following rules has also been added:
 
 Previously, if TypeScript failed to create and parse a program, these errors were not reported which lead to confusion around why linting was not working. Now, we report any issues with creating a program as a diagnostic, including configuration issues in `tsconfig.json` files.
 
-For example, if a `tsconfig.json` file contains `baseUrl`, that will be reported as an error, since `baseUrl` has been removed from TypeScript:
+For example, if a `tsconfig.json` file contains `baseUrl`, that will be reported as an error, since `baseUrl` has been removed from TypeScript in v7.0:
 
 ```
 $ oxlint --type-aware

From edf76d2c8a8964768805e4558ce30c85073e98a6 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:25:26 +0000
Subject: [PATCH 17/36] dprint

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index ff09051dafd..d58179719bf 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -117,7 +117,6 @@ Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like
 
 The configuration options are aligned with what `typescript-eslint` supports and documentation can be found in the configuration section for each rule (like [`no-floating-promises`](https://oxc.rs/docs/guide/usage/linter/rules/typescript/no-floating-promises.html#configuration)).
 
-
 In the technical preview, rule configurations were not passed to `tsgolint`, so customizing type-aware rules had no effect. Now, all configuration options are properly forwarded and applied.
 
 ### Disable comment support in `oxlint`
@@ -163,7 +162,6 @@ $ oxlint --type-aware
         See https://github.com/oxc-project/tsgolint/issues/351 for more information.
 ```
 
-
 ### Automatic fixes for type-aware rules
 
 Type-aware rules now support automatic fixes via the `--fix` flag. When you run `oxlint --type-aware --fix`, fixable diagnostics from `tsgolint` are applied just like regular `oxlint` fixes. This brings full parity with non-type-aware rules for the fix workflow.

From 1ba20bd8a1860cb88391c9e942c936066f2dc30a Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:27:15 +0000
Subject: [PATCH 18/36] add placeholder perf section

---
 src/blog/2025-12-01-type-aware-alpha.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index d58179719bf..ff1f025f5cd 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -168,7 +168,12 @@ Type-aware rules now support automatic fixes via the `--fix` flag. When you run
 
 ## Performance
 
-[Add performance benchmarks and comparisons]
+| Project         | Oxlint + Type Aware | ESLint + typescript-eslint |
+| --------------- | ------------------- | -------------------------- |
+| outlint/outlint | XXX                 | XXX                        |
+| vuejs/core      | XXXX                | XXX                        |
+
+Our performance testing shows that `oxlint` with type-aware linting is around X times faster that `eslint` with `typescript-eslint`. Take a look at our [performance benchmarks](https://github.com/oxc-project/bench-linter) for more details.
 
 ## Technical details
 

From 42a160a67aada5e5692e02ee6f41509d02b6e2d2 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:29:52 +0000
Subject: [PATCH 19/36] add yarn to quickstart

---
 src/blog/2025-12-01-type-aware-alpha.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index ff1f025f5cd..17643b0cdb2 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -68,6 +68,10 @@ npx oxlint --type-aware -A all -D typescript/no-floating-promises
 pnpx oxlint --type-aware -A all -D typescript/no-floating-promises
 ```
 
+```sh [yarn]
+yarn oxlint --type-aware -A all -D typescript/no-floating-promises
+```
+
 ```sh [bun]
 bunx oxlint --type-aware -A all -D typescript/no-floating-promises
 ```

From 4be25dea972d90c3afded84bae975703b8edd838 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:30:12 +0000
Subject: [PATCH 20/36] fix repo name

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 17643b0cdb2..40034621583 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -174,7 +174,7 @@ Type-aware rules now support automatic fixes via the `--fix` flag. When you run
 
 | Project         | Oxlint + Type Aware | ESLint + typescript-eslint |
 | --------------- | ------------------- | -------------------------- |
-| outlint/outlint | XXX                 | XXX                        |
+| outline/outline | XXX                 | XXX                        |
 | vuejs/core      | XXXX                | XXX                        |
 
 Our performance testing shows that `oxlint` with type-aware linting is around X times faster that `eslint` with `typescript-eslint`. Take a look at our [performance benchmarks](https://github.com/oxc-project/bench-linter) for more details.

From 7e73f09a5ec1d09ace18aa05096266c75a3eb124 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:30:19 +0000
Subject: [PATCH 21/36] update phrasing

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 40034621583..e27dc0e2b8a 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -202,7 +202,7 @@ This design keeps Oxlint's core fast while leveraging TypeScript's type system t
 
 ### TypeScript compatibility
 
-`tsgolint` is based on [typescript-go](https://github.com/microsoft/typescript-go), Microsoft's TypeScript v7.0 rewrite in Go, not the original TypeScript compiler. This means that you might encounter some features which are no longer supported.
+`tsgolint` is based on [typescript-go](https://github.com/microsoft/typescript-go), Microsoft's Go-based rewrite that will become TypeScript v7.0. This means that you might encounter some features which are no longer supported.
 
 **Important compatibility notes:**
 

From b4e6e09abe5981676c608a1b0273abd5c086d42c Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:30:59 +0000
Subject: [PATCH 22/36] u

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index e27dc0e2b8a..f5d9d55cc4f 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -56,7 +56,7 @@ bunx oxlint --type-aware
 
 :::
 
-To try a specific type-aware rule without other configuration (`tsgolint` must be installed globally or locally already):
+To try a specific type-aware rule without other configuration (`oxlint-tsgolint` must be installed globally or locally already):
 
 ::: code-group
 

From dc1f437070821c6a6a8ccb5784e4d2a45de76cb9 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:31:15 +0000
Subject: [PATCH 23/36] u

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index f5d9d55cc4f..b3e09981b4b 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -226,7 +226,7 @@ While `tsgolint` is ready for testing in production codebases, you may encounter
 
 We're actively working on the following improvements for the beta release:
 
-- **More supported rules** - Currently we support 43 out the 59 type-aware rules from `typescript-eslint`. As we head towards a beta release, we plan to continue expanding rule coverage.
+- **More supported rules** - Currently we support 43 out of the 59 type-aware rules from `typescript-eslint`. As we head towards a beta release, we plan to continue expanding rule coverage.
 - **Performance and memory usage improvements** - We're going to continue to optimize performance, especially for very large monorepos.
 
 ## Try it out

From 15a8abab7bfa842bb18bdb4ecb011b1b7c8abfa7 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:31:31 +0000
Subject: [PATCH 24/36] u

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index b3e09981b4b..b217d6215ce 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -148,7 +148,7 @@ Since the initial preview, support for the following rules has also been added:
 
 ### TypeScript program diagnostics are now reported
 
-Previously, if TypeScript failed to create and parse a program, these errors were not reported which lead to confusion around why linting was not working. Now, we report any issues with creating a program as a diagnostic, including configuration issues in `tsconfig.json` files.
+Previously, if TypeScript failed to create and parse a program, these errors were not reported which led to confusion around why linting was not working. Now, we report any issues with creating a program as a diagnostic, including configuration issues in `tsconfig.json` files.
 
 For example, if a `tsconfig.json` file contains `baseUrl`, that will be reported as an error, since `baseUrl` has been removed from TypeScript in v7.0:
 

From 9414a617821b334a53e1b4a7324f598e977f2543 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 00:32:34 +0000
Subject: [PATCH 25/36] update try it out

---
 src/blog/2025-12-01-type-aware-alpha.md | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index b217d6215ce..9bad1528262 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -231,11 +231,6 @@ We're actively working on the following improvements for the beta release:
 
 ## Try it out
 
-Install `oxlint` and `oxlint-tsgolint`, then run with the `--type-aware` flag:
-
-```sh
-pnpm add -D oxlint oxlint-tsgolint
-pnpm oxlint --type-aware
-```
+Ready to get started? Head to the [Quick Start](#quick-start) section above to install and run type-aware linting.
 
 We'd love to hear your feedback! If you encounter any issues, please report them in the [oxlint](https://github.com/oxc-project/oxc) or [tsgolint](https://github.com/oxc-project/tsgolint) repositories.

From 6d879aa965939213ae5a5bf661cb554be6269da9 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 22:36:21 +0000
Subject: [PATCH 26/36] add benchmarks

---
 src/blog/2025-12-01-type-aware-alpha.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 9bad1528262..eebaa52b676 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -172,12 +172,14 @@ Type-aware rules now support automatic fixes via the `--fix` flag. When you run
 
 ## Performance
 
-| Project         | Oxlint + Type Aware | ESLint + typescript-eslint |
-| --------------- | ------------------- | -------------------------- |
-| outline/outline | XXX                 | XXX                        |
-| vuejs/core      | XXXX                | XXX                        |
+| Project         | Oxlint + Type Aware | ESLint + typescript-eslint | Improvement |
+| --------------- | ------------------- | -------------------------- | ----------- |
+| vuejs/core      | 2.531 s             | 20.800 s                   | 8.22x       |
+| outline/outline | 4.448 s             | 55.070 s                   | 12.38x      |
 
-Our performance testing shows that `oxlint` with type-aware linting is around X times faster that `eslint` with `typescript-eslint`. Take a look at our [performance benchmarks](https://github.com/oxc-project/bench-linter) for more details.
+Benchmarks were performed on a MacBook Pro M2 Max 12 Cores (8 performance and 4 efficiency).
+
+Our performance testing shows that `oxlint` with type-aware linting is around 10 times faster that `eslint` with `typescript-eslint`. Take a look at our [performance benchmarks](https://github.com/oxc-project/bench-linter) for more details.
 
 ## Technical details
 

From 5b8927a9a3222eb39f8a67605240b9b76977e8fa Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 22:45:40 +0000
Subject: [PATCH 27/36] move perf section up below quick start

---
 src/blog/2025-12-01-type-aware-alpha.md | 26 +++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index eebaa52b676..0a20313bd63 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -80,7 +80,20 @@ bunx oxlint --type-aware -A all -D typescript/no-floating-promises
 
 For more configuration options, see our [usage guide](/docs/guide/usage/linter/type-aware).
 
-## What's new
+## Performance
+
+| Project         | Oxlint + Type Aware | ESLint + typescript-eslint | Improvement |
+| --------------- | ------------------- | -------------------------- | ----------- |
+| vuejs/core      | 2.531 s             | 20.800 s                   | 8.22x       |
+| outline/outline | 4.448 s             | 55.070 s                   | 12.38x      |
+
+Benchmarks were performed on a MacBook Pro M2 Max 12 Cores (8 performance and 4 efficiency).
+
+Our performance testing shows that `oxlint` with type-aware linting is around 10 times faster than `eslint` with `typescript-eslint`. Take a look at our [performance benchmarks](https://github.com/oxc-project/bench-linter) for more details.
+
+Oxlint can also be used to typecheck your codebase while linting. This avoids a duplicate work, as much of the type information is already computed during type-aware linting..
+
+## What's new since the technical preview?
 
 ### Support for type-checking while linting
 
@@ -170,17 +183,6 @@ $ oxlint --type-aware
 
 Type-aware rules now support automatic fixes via the `--fix` flag. When you run `oxlint --type-aware --fix`, fixable diagnostics from `tsgolint` are applied just like regular `oxlint` fixes. This brings full parity with non-type-aware rules for the fix workflow.
 
-## Performance
-
-| Project         | Oxlint + Type Aware | ESLint + typescript-eslint | Improvement |
-| --------------- | ------------------- | -------------------------- | ----------- |
-| vuejs/core      | 2.531 s             | 20.800 s                   | 8.22x       |
-| outline/outline | 4.448 s             | 55.070 s                   | 12.38x      |
-
-Benchmarks were performed on a MacBook Pro M2 Max 12 Cores (8 performance and 4 efficiency).
-
-Our performance testing shows that `oxlint` with type-aware linting is around 10 times faster that `eslint` with `typescript-eslint`. Take a look at our [performance benchmarks](https://github.com/oxc-project/bench-linter) for more details.
-
 ## Technical details
 
 ### Architecture

From d76882858874a5cb33c1dab89483afa4b96ed2cf Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 22:46:51 +0000
Subject: [PATCH 28/36] move known issues section up into performance section

---
 src/blog/2025-12-01-type-aware-alpha.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 0a20313bd63..29c19522054 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -93,6 +93,10 @@ Our performance testing shows that `oxlint` with type-aware linting is around 10
 
 Oxlint can also be used to typecheck your codebase while linting. This avoids a duplicate work, as much of the type information is already computed during type-aware linting..
 
+:::warning Known Issues
+While `tsgolint` is ready for testing in production codebases, you may encounter issues with running out of memory when working with very large codebases. We are working on optimizing the memory usage for the next milestone. We would love if you tried `tsgolint` and reported any out-of-memory issues to us in the [`tsgolint` repository](https://github.com/oxc-project/tsgolint) and included some details about your project to help us improve memory usage.
+:::
+
 ## What's new since the technical preview?
 
 ### Support for type-checking while linting
@@ -222,10 +226,6 @@ If you're using deprecated features from TypeScript 6.0 or earlier, you'll need
 
 Our typescript-go fork is synced regularly using renovatebot, ensuring we stay current with the latest improvements and fixes. Once TypeScript 7.0 is officially released, we will track stable releases rather than the tip of the main branch.
 
-### Known issues
-
-While `tsgolint` is ready for testing in production codebases, you may encounter issues with running out of memory when working with very large codebases. We are working on optimizing the memory usage for the next milestone. We would love if you tried `tsgolint` and reported any out-of-memory issues to us in the [`tsgolint` repository](https://github.com/oxc-project/tsgolint) and included some details about your project to help us improve memory usage.
-
 ## What's next
 
 We're actively working on the following improvements for the beta release:

From 2b49ee5947078a5bce23c22f9d6a64e90ac838e9 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 22:50:27 +0000
Subject: [PATCH 29/36] remove the previous behaviour section for new features

---
 src/blog/2025-12-01-type-aware-alpha.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 29c19522054..b5f399bce2e 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -138,8 +138,6 @@ Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like
 
 The configuration options are aligned with what `typescript-eslint` supports and documentation can be found in the configuration section for each rule (like [`no-floating-promises`](https://oxc.rs/docs/guide/usage/linter/rules/typescript/no-floating-promises.html#configuration)).
 
-In the technical preview, rule configurations were not passed to `tsgolint`, so customizing type-aware rules had no effect. Now, all configuration options are properly forwarded and applied.
-
 ### Disable comment support in `oxlint`
 
 Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` rule by placing a comment in the file or on a line:
@@ -151,8 +149,6 @@ Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` r
 [1, 2, 3].map(async (x) => x + 1);
 ```
 
-In the technical preview, disable comments were ignored for type-aware rules. Now, they work exactly as you would expect.
-
 ### More supported rules
 
 We've continued to make progress on porting popular rules from `typescript-eslint` which you can now use via `oxlint`. `tsgolint`, combined with `oxlint`, currently supports 43 type-aware rules.

From a146f9fe3bdaed6eb71dd6a517c8e405bb9f1768 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 22:50:42 +0000
Subject: [PATCH 30/36] update inline disable comment section title

---
 src/blog/2025-12-01-type-aware-alpha.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index b5f399bce2e..1954aabb4dc 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -138,7 +138,7 @@ Type-aware rules that run in `tsgolint` can be configured in `oxlint` just like
 
 The configuration options are aligned with what `typescript-eslint` supports and documentation can be found in the configuration section for each rule (like [`no-floating-promises`](https://oxc.rs/docs/guide/usage/linter/rules/typescript/no-floating-promises.html#configuration)).
 
-### Disable comment support in `oxlint`
+### In-line disable comment support in `oxlint`
 
 Rules that run in `tsgolint` can now be disabled similar to any other `oxlint` rule by placing a comment in the file or on a line:
 

From d1e39fca157319a6dc021d8d0a567612ae61b415 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 22:53:23 +0000
Subject: [PATCH 31/36] link to rule docs

---
 src/blog/2025-12-01-type-aware-alpha.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 1954aabb4dc..7ae2b848091 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -155,9 +155,9 @@ We've continued to make progress on porting popular rules from `typescript-eslin
 
 Since the initial preview, support for the following rules has also been added:
 
-- `no-deprecated` (one of the most commonly requested rules)
-- `prefer-includes`
-- `strict-boolean-expressions`
+- [`no-deprecated`](/docs/guide/usage/linter/rules/typescript/no-deprecated) (one of the most commonly requested rules)
+- [`prefer-includes`](/docs/guide/usage/linter/rules/typescript/prefer-includes)
+- [`strict-boolean-expressions`](/docs/guide/usage/linter/rules/typescript/strict-boolean-expressions)
 
 ### TypeScript program diagnostics are now reported
 

From 32bd0a877b1a2c49fdbfedcdc3b489b5adf1add2 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 22:55:40 +0000
Subject: [PATCH 32/36] add acknowledgements

---
 src/blog/2025-12-01-type-aware-alpha.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 7ae2b848091..051744d4a2f 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -229,6 +229,16 @@ We're actively working on the following improvements for the beta release:
 - **More supported rules** - Currently we support 43 out of the 59 type-aware rules from `typescript-eslint`. As we head towards a beta release, we plan to continue expanding rule coverage.
 - **Performance and memory usage improvements** - We're going to continue to optimize performance, especially for very large monorepos.
 
+## Acknowledgements
+
+
+We'd like to extend our gratitude to:
+
+- The TypeScript team for creating `typescript-go`.
+- The `typescript-eslint` team for their heartwarming support.
+- [@auvred](https://github.com/auvred) for creating `tsgolint`.
+- [@camchenry](https://github.com/camchenry) for continued performance work, as well as implementing rule option support.
+
 ## Try it out
 
 Ready to get started? Head to the [Quick Start](#quick-start) section above to install and run type-aware linting.

From daba3bbfc847a6cf1b533b4b3a81a629071cdeda Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 22:55:51 +0000
Subject: [PATCH 33/36] add more details to feedback section

---
 src/blog/2025-12-01-type-aware-alpha.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index 051744d4a2f..f71fff18dc7 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -243,4 +243,10 @@ We'd like to extend our gratitude to:
 
 Ready to get started? Head to the [Quick Start](#quick-start) section above to install and run type-aware linting.
 
-We'd love to hear your feedback! If you encounter any issues, please report them in the [oxlint](https://github.com/oxc-project/oxc) or [tsgolint](https://github.com/oxc-project/tsgolint) repositories.
+We'd love to hear your feedback on type-aware linting and are excited to see how it helps improve your development workflow.
+
+Connect with us:
+
+- **Discord**: Join our [community server](https://discord.gg/9uXCAwqQZW) for real-time discussions
+- **GitHub**: Share feedback on [GitHub Discussions](https://github.com/oxc-project/oxc/discussions)
+- **Issues**: Report `oxlint` bugs to [oxc](https://github.com/oxc-project/oxc/issues) and type-aware linting bugs to [tsgolint](https://github.com/oxc-project/tsgolint/issues).

From 8d3d3176824406c23296f83fb3c303433479d013 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 23:00:53 +0000
Subject: [PATCH 34/36] update type aware guide

---
 src/docs/guide/usage/linter/type-aware.md | 25 +++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/src/docs/guide/usage/linter/type-aware.md b/src/docs/guide/usage/linter/type-aware.md
index 996dee3d4e7..52b65cf2bd2 100644
--- a/src/docs/guide/usage/linter/type-aware.md
+++ b/src/docs/guide/usage/linter/type-aware.md
@@ -30,12 +30,6 @@ Run `oxlint` with `--type-aware`
 oxlint --type-aware
 ```
 
-## Unsupported Features
-
-The following issues will be addressed for the alpha version.
-
-- Auto-fixes for type-aware rules only work in the VS Code extension, not in the CLI (`oxlint --fix`)
-
 ## Unimplemented Rules
 
 See https://github.com/oxc-project/tsgolint/issues/104
@@ -99,3 +93,22 @@ tsgolint is based on [typescript-go](https://github.com/microsoft/typescript-go)
 - If you're using deprecated features that were deprecated in TypeScript 6.0 or removed in TypeScript 7.0, you'll need to migrate your codebase first
 
 For help migrating deprecated tsconfig options, see the [TypeScript migration guide](https://github.com/microsoft/TypeScript/issues/62508#issuecomment-3348649259).
+
+## Architecture
+
+Type-aware linting in Oxlint uses a unique two-binary architecture:
+
+```
+oxlint CLI (Rust)
+  ├─ Handles file traversal, ignore logic, and diagnostics
+  ├─ Runs non-type-aware rules and custom JS plugins
+  ├─ Passes paths and configuration to tsgolint
+  └─ Formats and displays results
+
+tsgolint (Go)
+  ├─ Uses typescript-go directly for type checking
+  ├─ Executes type-aware rules
+  └─ Returns structured diagnostics
+```
+
+This design keeps Oxlint's core fast while leveraging TypeScript's type system through typescript-go. The frontend-backend separation means `oxlint` controls the user experience while `tsgolint` handles the heavy lifting of type analysis.
\ No newline at end of file

From 373d2e7a7fbe8128851d5d90d41adb0e1601eb9b Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 23:01:43 +0000
Subject: [PATCH 35/36] u

---
 src/blog/2025-12-01-type-aware-alpha.md | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index f71fff18dc7..d9e9d88b9ff 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -18,15 +18,13 @@ Following our [technical preview in August](/blog/2025-08-17-oxlint-type-aware),
 
 Type-aware linting enables powerful rules like `no-floating-promises`, `no-misused-promises`, and `await-thenable` that catch bugs by utilizing TypeScript's type system. With 43 type-aware rules now available, you can catch entire categories of runtime errors before they happen.
 
-The alpha release addresses the major limitations from the technical preview:
+**In this post:**
 
-- **Full rule configuration support** - Configure individual type-aware rules in `.oxlintrc.json`
-- **Disable comment support** - Use `eslint-disable` comments to control type-aware rules
-- **IDE support** - Type-aware linting works in VSCode and other supported editors
-- **Improved stability** - Many crashes and edge cases have been fixed
-- **Better performance** - Less memory used and slightly better rule performance in some cases
-
-While we're still working on performance for very large monorepos and some advanced rules, the alpha is ready for testing in production codebases.
+- [Quick Start](#quick-start) - Get started with type-aware linting in minutes
+- [Performance](#performance) - See how much faster type-aware linting is compared to ESLint
+- [What's new since the technical preview](#what-s-new-since-the-technical-preview) - New features and improvements
+- [Technical details](#technical-details) - How type-aware linting works under the hood
+- [What's next](#what-s-next) - Upcoming improvements for the beta release
 
 ## Quick Start
 

From f578265f8779518344bf65677e87422aa0f7bce6 Mon Sep 17 00:00:00 2001
From: Cameron Clark <cameron.clark@hey.com>
Date: Thu, 4 Dec 2025 23:02:20 +0000
Subject: [PATCH 36/36] lint

---
 src/blog/2025-12-01-type-aware-alpha.md   | 1 -
 src/docs/guide/usage/linter/type-aware.md | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/blog/2025-12-01-type-aware-alpha.md b/src/blog/2025-12-01-type-aware-alpha.md
index d9e9d88b9ff..9868d433581 100644
--- a/src/blog/2025-12-01-type-aware-alpha.md
+++ b/src/blog/2025-12-01-type-aware-alpha.md
@@ -229,7 +229,6 @@ We're actively working on the following improvements for the beta release:
 
 ## Acknowledgements
 
-
 We'd like to extend our gratitude to:
 
 - The TypeScript team for creating `typescript-go`.
diff --git a/src/docs/guide/usage/linter/type-aware.md b/src/docs/guide/usage/linter/type-aware.md
index 52b65cf2bd2..c6010a37563 100644
--- a/src/docs/guide/usage/linter/type-aware.md
+++ b/src/docs/guide/usage/linter/type-aware.md
@@ -111,4 +111,4 @@ tsgolint (Go)
   └─ Returns structured diagnostics
 ```
 
-This design keeps Oxlint's core fast while leveraging TypeScript's type system through typescript-go. The frontend-backend separation means `oxlint` controls the user experience while `tsgolint` handles the heavy lifting of type analysis.
\ No newline at end of file
+This design keeps Oxlint's core fast while leveraging TypeScript's type system through typescript-go. The frontend-backend separation means `oxlint` controls the user experience while `tsgolint` handles the heavy lifting of type analysis.