diff --git a/src/content/docs/features/shell.mdx b/src/content/docs/features/shell.mdx
index a5e1debae2..f7b55cbec4 100644
--- a/src/content/docs/features/shell.mdx
+++ b/src/content/docs/features/shell.mdx
@@ -3,11 +3,109 @@ title: Shell
 description: Access the system shell to manage files and URLs using their default application and to spawn child processes.
 ---
 
-import Stub from '@components/Stub.astro';
 import PluginLinks from '@components/PluginLinks.astro';
+import { Tabs, TabItem } from '@astrojs/starlight/components';
+import CommandTabs from '@components/CommandTabs.astro';
 
 <PluginLinks plugin="shell" />
 
-<Stub>
-	Based on https://github.com/tauri-apps/plugins-workspace/tree/v2/plugins/shell
-</Stub>
+Access the system shell. Allows you to spawn child processes and manage files and URLs using their default application.
+
+## Supported Platforms
+
+- Windows
+- Linux
+- macOS
+
+## Setup
+
+_This plugin requires a Rust version of at least **1.75**_
+
+Install the shell plugin to get started.
+
+<Tabs>
+  <TabItem label="Automatic">
+
+Use your project's package manager to add the dependency:
+
+{' '}
+
+<CommandTabs
+	npm="npm run tauri add shell"
+	yarn="yarn run tauri add shell"
+	pnpm="pnpm tauri add shell"
+	cargo="cargo tauri add shell"
+/>
+
+  </TabItem>
+  <TabItem label="Manual">
+
+1. Install the Core plugin by adding the following to your `Cargo.toml` file:
+
+```toml title="src-tauri/Cargo.toml"
+[dependencies]
+tauri-plugin-shell = "2.0.0-beta"
+# alternatively with Git:
+tauri-plugin-shell = { git = "https://github.com/tauri-apps/plugins-workspace", branch = "v2" }
+```
+
+2. Modify `lib.rs` to initialize the plugin:
+
+```rust title="src-tauri/src/lib.rs" {3}
+fn run() {
+    tauri::Builder::default()
+        .plugin(tauri_plugin_shell::init())
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}
+```
+
+3. Install the JavaScript Guest bindings using your preferred JavaScript package manager:
+
+  <CommandTabs
+      npm="npm install @tauri-apps/plugin-shell"
+      yarn="yarn add @tauri-apps/plugin-shell"
+      pnpm="pnpm add @tauri-apps/plugin-shell"
+  />
+  </TabItem>
+</Tabs>
+
+## Usage
+
+The plugin's APIs are available through the JavaScript guest bindings:
+
+```javascript
+import { Command } from "@tauri-apps/plugin-shell";
+
+Command.create("git", ["commit", "-m", "the commit message"]);
+```
+
+## Permissions
+
+By default all plugin commands are blocked and cannot be accessed.
+You must define a list of permissions in your `capabilities` configuration.
+
+See [Access Control List](/references/v2/acl) for more information.
+
+```json title="src-tauri/capabilities/main.json" ins={4-7}
+{
+  "permissions": [
+		...,
+		"shell:allow-execute",
+		"shell:allow-kill",
+		"shell:allow-open",
+		"shell:allow-stdin-write",
+  ]
+}
+```
+
+| Permission | Description |
+|------|-----|
+|`shell:allow-execute`|Enables the execute command without any pre-configured scope.|
+|`shell:deny-execute`|Denies the execute command without any pre-configured scope.|
+|`shell:allow-kill`|Enables the kill command without any pre-configured scope.|
+|`shell:deny-kill`|Denies the kill command without any pre-configured scope.|
+|`shell:allow-open`|Enables the open command without any pre-configured scope.|
+|`shell:deny-open`|Denies the open command without any pre-configured scope.|
+|`shell:allow-stdin-write`|Enables the stdin_write command without any pre-configured scope.|
+|`shell:deny-stdin-write`|Denies the stdin_write command without any pre-configured scope.|
\ No newline at end of file
diff --git a/src/content/docs/features/window-state.mdx b/src/content/docs/features/window-state.mdx
index f580f6e1a9..1b2494251c 100644
--- a/src/content/docs/features/window-state.mdx
+++ b/src/content/docs/features/window-state.mdx
@@ -72,7 +72,7 @@ fn main() {
 
 ## Usage
 
-After adding the all windows will remember their state when the app is being closed and will restore to their previous state on the next launch.
+After adding the plugin all windows will remember their state when the app is being closed and will restore to their previous state on the next launch.
 
 You can also access the window-state plugin in both JavaScript and Rust.