diff --git a/.scripts/samples.js b/.scripts/samples.js
index 73876948..ba1dbcc9 100644
--- a/.scripts/samples.js
+++ b/.scripts/samples.js
@@ -69,7 +69,13 @@ const samples = [
 	// { description: 'quickinput-sample', path: 'quickinput-sample', guide: null, apis: [], contributions: [] },
 	// { description: 'smart-template-strings-sample', path: 'smart-template-strings-sample', guide: null, apis: [], contributions: [] },
 	// { description: 'task-provider-sample', path: 'task-provider-sample', guide: null, apis: [], contributions: [] },
-	// { description: 'terminal-sample', path: 'terminal-sample', guide: null, apis: [], contributions: [] },
+	{ 
+		description: 'terminal-sample',
+		path: 'terminal-sample',
+		guide: null,
+		apis: ['window.createTerminal', 'window.onDidChangeActiveTerminal', 'window.onDidCloseTerminal', 'window.onDidOpenTerminal', 'window.Terminal', 'window.terminals'],
+		contributions: []
+	},
 	// { description: 'theme-sample', path: 'theme-sample', guide: null, apis: [], contributions: [] },
 	// { description: 'tree-view-sample', path: 'tree-view-sample', guide: null, apis: [], contributions: [] },
 	// { description: 'vim-sample', path: 'vim-sample', guide: null, apis: [], contributions: [] },
diff --git a/README.md b/README.md
index de080d28..f1b74574 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,7 @@ You can expect from each sample:
 | [LSP Sample](lsp-sample) | [/api/language-extensions/smart-editing-lsp-guide](https://vscode-ext-docs.azurewebsites.net/api/language-extensions/smart-editing-lsp-guide) |  |
 | [LSP Log Streaming Sample](lsp-log-streaming-sample) | N/A |  |
 | [LSP Multi Root Server Sample](lsp-multi-server-sample) | https://github.com/Microsoft/vscode/wiki/Extension-Authoring:-Adopting-Multi-Root-Workspace-APIs#language-client--language-server |  |
+| [terminal-sample](terminal-sample) | N/A | [window.createTerminal](https://vscode-ext-docs.azurewebsites.net/api/references/vscode-api#window.createTerminal)<br>[window.onDidChangeActiveTerminal](https://vscode-ext-docs.azurewebsites.net/api/references/vscode-api#window.onDidChangeActiveTerminal)<br>[window.onDidCloseTerminal](https://vscode-ext-docs.azurewebsites.net/api/references/vscode-api#window.onDidCloseTerminal)<br>[window.onDidOpenTerminal](https://vscode-ext-docs.azurewebsites.net/api/references/vscode-api#window.onDidOpenTerminal)<br>[window.Terminal](https://vscode-ext-docs.azurewebsites.net/api/references/vscode-api#window.Terminal)<br>[window.terminals](https://vscode-ext-docs.azurewebsites.net/api/references/vscode-api#window.terminals) |
 <!-- SAMPLES_END -->
 
 ## :warning: Legacy Samples :warning: