From 24cba12dbc748e524b1cc072ab5ccd2e8c72b34b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ant=C3=B3n=20Molleda?= <amolleda@gmail.com>
Date: Thu, 7 Oct 2021 15:56:54 -0700
Subject: [PATCH] docs: update source

---
 docs/latest/api/menu.md                                  | 2 +-
 docs/latest/api/native-theme.md                          | 9 ++++++---
 docs/latest/api/touch-bar.md                             | 2 +-
 docs/latest/api/tray.md                                  | 2 +-
 docs/latest/api/web-contents.md                          | 1 +
 docs/latest/api/webview-tag.md                           | 4 +++-
 .../development/debugging-instructions-macos-xcode.md    | 2 +-
 docs/latest/development/issues.md                        | 2 +-
 docs/latest/development/pull-requests.md                 | 3 ++-
 docs/latest/faq.md                                       | 2 +-
 docs/latest/styleguide.md                                | 1 +
 docs/latest/tutorial/application-distribution.md         | 2 +-
 docs/latest/tutorial/context-isolation.md                | 2 +-
 docs/latest/tutorial/dark-mode.md                        | 2 +-
 docs/latest/tutorial/in-app-purchases.md                 | 2 +-
 docs/latest/tutorial/keyboard-shortcuts.md               | 2 +-
 .../tutorial/launch-app-from-url-in-another-app.md       | 3 +++
 docs/latest/tutorial/linux-desktop-actions.md            | 2 +-
 docs/latest/tutorial/mac-app-store-submission-guide.md   | 1 +
 docs/latest/tutorial/message-ports.md                    | 3 +++
 docs/latest/tutorial/native-file-drag-drop.md            | 2 +-
 docs/latest/tutorial/notifications.md                    | 2 +-
 docs/latest/tutorial/offscreen-rendering.md              | 2 +-
 docs/latest/tutorial/online-offline-events.md            | 2 +-
 docs/latest/tutorial/process-model.md                    | 1 +
 docs/latest/tutorial/progress-bar.md                     | 2 +-
 docs/latest/tutorial/quick-start.md                      | 5 +++++
 docs/latest/tutorial/recent-documents.md                 | 2 +-
 docs/latest/tutorial/represented-file.md                 | 2 +-
 docs/latest/tutorial/sandbox.md                          | 2 ++
 docs/latest/tutorial/security.md                         | 8 ++++++++
 docs/latest/tutorial/support.md                          | 2 +-
 docs/latest/tutorial/tray.md                             | 1 +
 docs/latest/tutorial/web-embeds.md                       | 2 +-
 docs/latest/tutorial/windows-taskbar.md                  | 2 +-
 35 files changed, 59 insertions(+), 27 deletions(-)

diff --git a/docs/latest/api/menu.md b/docs/latest/api/menu.md
index 8dcd823f5..de3053de8 100644
--- a/docs/latest/api/menu.md
+++ b/docs/latest/api/menu.md
@@ -1,6 +1,6 @@
 ---
 title: "Menu"
-description: ""
+description: "Create native application menus and context menus."
 slug: menu
 hide_title: false
 ---
diff --git a/docs/latest/api/native-theme.md b/docs/latest/api/native-theme.md
index 1bbd838be..4ccf3b4f0 100644
--- a/docs/latest/api/native-theme.md
+++ b/docs/latest/api/native-theme.md
@@ -59,9 +59,12 @@ Settings this property to `light` will have the following effects:
 The usage of this property should align with a classic "dark mode" state machine in your application
 where the user has three options.
 
-* `Follow OS` --> `themeSource = 'system'`
-* `Dark Mode` --> `themeSource = 'dark'`
-* `Light Mode` --> `themeSource = 'light'`
+* `Follow OS` -->
+ `themeSource = 'system'`
+* `Dark Mode` -->
+ `themeSource = 'dark'`
+* `Light Mode` -->
+ `themeSource = 'light'`
 
 Your application should then always use `shouldUseDarkColors` to determine what CSS to apply.
 
diff --git a/docs/latest/api/touch-bar.md b/docs/latest/api/touch-bar.md
index bf044cc77..cf459f1ed 100644
--- a/docs/latest/api/touch-bar.md
+++ b/docs/latest/api/touch-bar.md
@@ -1,6 +1,6 @@
 ---
 title: "TouchBar"
-description: ""
+description: "Create TouchBar layouts for native macOS applications"
 slug: touch-bar
 hide_title: false
 ---
diff --git a/docs/latest/api/tray.md b/docs/latest/api/tray.md
index a2dd75b80..a0115cefe 100644
--- a/docs/latest/api/tray.md
+++ b/docs/latest/api/tray.md
@@ -1,6 +1,6 @@
 ---
 title: "Tray"
-description: ""
+description: "Add icons and context menus to the system's notification area."
 slug: tray
 hide_title: false
 ---
diff --git a/docs/latest/api/web-contents.md b/docs/latest/api/web-contents.md
index 1058db84b..017410e2a 100644
--- a/docs/latest/api/web-contents.md
+++ b/docs/latest/api/web-contents.md
@@ -1703,6 +1703,7 @@ app.whenReady().then(() => {
 
 ```html
 <!-- index.html -->
+
 <html>
 <body>
   <script>
diff --git a/docs/latest/api/webview-tag.md b/docs/latest/api/webview-tag.md
index 3b0448d58..8aa2151f6 100644
--- a/docs/latest/api/webview-tag.md
+++ b/docs/latest/api/webview-tag.md
@@ -1,6 +1,6 @@
 ---
 title: "`<webview>` Tag"
-description: ""
+description: "Electron's webview tag is based on Chromium's webview, which is undergoing dramatic architectural changes. This impacts the stability of webviews, including rendering, navigation, and event routing. We currently recommend to not use the webview tag and to consider alternatives, like iframe, Electron's BrowserView, or an architecture that avoids embedded content altogether."
 slug: webview-tag
 hide_title: false
 ---
@@ -151,8 +151,10 @@ browser plugins. Plugins are disabled by default.
 
 ```html
 <!-- from a file -->
+
 <webview src="https://www.github.com/" preload="./test.js"></webview>
 <!-- or if you want to load from an asar archive -->
+
 <webview src="https://www.github.com/" preload="./app.asar/test.js"></webview>
 ```
 
diff --git a/docs/latest/development/debugging-instructions-macos-xcode.md b/docs/latest/development/debugging-instructions-macos-xcode.md
index 9cca9cc91..c455e5c45 100644
--- a/docs/latest/development/debugging-instructions-macos-xcode.md
+++ b/docs/latest/development/debugging-instructions-macos-xcode.md
@@ -1,6 +1,6 @@
 ---
 title: "Debugging with XCode"
-description: ""
+description: "Run gn gen with the --ide=xcode argument."
 slug: debugging-instructions-macos-xcode
 hide_title: false
 ---
diff --git a/docs/latest/development/issues.md b/docs/latest/development/issues.md
index 5ddd6594d..47ca5898a 100644
--- a/docs/latest/development/issues.md
+++ b/docs/latest/development/issues.md
@@ -1,6 +1,6 @@
 ---
 title: "Issues In Electron"
-description: ""
+description: "For any issue, there are fundamentally three ways an individual can contribute:"
 slug: issues
 hide_title: false
 ---
diff --git a/docs/latest/development/pull-requests.md b/docs/latest/development/pull-requests.md
index eb4a4994e..66c920324 100644
--- a/docs/latest/development/pull-requests.md
+++ b/docs/latest/development/pull-requests.md
@@ -1,6 +1,6 @@
 ---
 title: "Pull Requests"
-description: ""
+description: "Fork the project on GitHub and clone your fork locally."
 slug: pull-requests
 hide_title: false
 ---
@@ -198,6 +198,7 @@ Bug fixes and new features should include tests and possibly benchmarks.
 
 Contributors guide: https://github.com/electron/electron/blob/main/CONTRIBUTING.md
 -->
+
 ```
 
 ### Step 10: Discuss and update
diff --git a/docs/latest/faq.md b/docs/latest/faq.md
index 57b10ad1a..240548cc6 100644
--- a/docs/latest/faq.md
+++ b/docs/latest/faq.md
@@ -1,6 +1,6 @@
 ---
 title: "Electron FAQ"
-description: ""
+description: "When running npm install electron, some users occasionally encounter installation errors."
 slug: faq
 hide_title: false
 ---
diff --git a/docs/latest/styleguide.md b/docs/latest/styleguide.md
index afa1594f8..cb3b5cc10 100644
--- a/docs/latest/styleguide.md
+++ b/docs/latest/styleguide.md
@@ -57,6 +57,7 @@ folder.
 There are a few style guidelines that aren't covered by the linter rules:
 
 <!--TODO(erickzhao): make sure this matches with the lint:markdownlint task-->
+
 * Use `sh` instead of `cmd` in code blocks (due to the syntax highlighter).
 * Keep line lengths between 80 and 100 characters if possible for readability
   purposes.
diff --git a/docs/latest/tutorial/application-distribution.md b/docs/latest/tutorial/application-distribution.md
index 201d79509..f70935df2 100644
--- a/docs/latest/tutorial/application-distribution.md
+++ b/docs/latest/tutorial/application-distribution.md
@@ -1,6 +1,6 @@
 ---
 title: "Application Distribution"
-description: ""
+description: "To distribute your app with Electron, you need to package and rebrand it. To do this, you can either use specialized tooling or manual approaches."
 slug: application-distribution
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/context-isolation.md b/docs/latest/tutorial/context-isolation.md
index 935c0150e..83596921f 100644
--- a/docs/latest/tutorial/context-isolation.md
+++ b/docs/latest/tutorial/context-isolation.md
@@ -1,6 +1,6 @@
 ---
 title: "Context Isolation"
-description: ""
+description: "Context Isolation is a feature that ensures that both your preload scripts and Electron's internal logic run in a separate context to the website you load in a webContents.  This is important for security purposes as it helps prevent the website from accessing Electron internals or the powerful APIs your preload script has access to."
 slug: context-isolation
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/dark-mode.md b/docs/latest/tutorial/dark-mode.md
index c406bad88..481f72560 100644
--- a/docs/latest/tutorial/dark-mode.md
+++ b/docs/latest/tutorial/dark-mode.md
@@ -1,6 +1,6 @@
 ---
 title: "Dark Mode"
-description: ""
+description: "\"Native interfaces\" include the file picker, window border, dialogs, context menus, and more - anything where the UI comes from your operating system and not from your app. The default behavior is to opt into this automatic theming from the OS."
 slug: dark-mode
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/in-app-purchases.md b/docs/latest/tutorial/in-app-purchases.md
index 177e62d60..71b3e72c6 100644
--- a/docs/latest/tutorial/in-app-purchases.md
+++ b/docs/latest/tutorial/in-app-purchases.md
@@ -1,6 +1,6 @@
 ---
 title: "In-App Purchases (macOS)"
-description: ""
+description: "If you haven't already, you’ll need to sign the Paid Applications Agreement and set up your banking and tax information in iTunes Connect."
 slug: in-app-purchases
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/keyboard-shortcuts.md b/docs/latest/tutorial/keyboard-shortcuts.md
index a2e4a567a..4563880e4 100644
--- a/docs/latest/tutorial/keyboard-shortcuts.md
+++ b/docs/latest/tutorial/keyboard-shortcuts.md
@@ -1,6 +1,6 @@
 ---
 title: "Keyboard Shortcuts"
-description: ""
+description: "This feature allows you to configure local and global keyboard shortcuts for your Electron application."
 slug: keyboard-shortcuts
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/launch-app-from-url-in-another-app.md b/docs/latest/tutorial/launch-app-from-url-in-another-app.md
index 4a418790a..478d0c244 100644
--- a/docs/latest/tutorial/launch-app-from-url-in-another-app.md
+++ b/docs/latest/tutorial/launch-app-from-url-in-another-app.md
@@ -11,6 +11,7 @@ hide_title: true
 
 <!-- ✍ Update this section if you want to provide more details -->
 
+
 This guide will take you through the process of setting your Electron app as the default
 handler for a specific [protocol](https://www.electronjs.org/docs/api/protocol).
 
@@ -207,8 +208,10 @@ show an error dialog box.
     can leave it empty.
 -->
 
+
 ```fiddle docs/latest/fiddles/system/protocol-handler/launch-app-from-URL-in-another-app
 
 ```
 
 <!-- ✍ Explanation of the code below -->
+
diff --git a/docs/latest/tutorial/linux-desktop-actions.md b/docs/latest/tutorial/linux-desktop-actions.md
index c286fcce4..290955bb9 100644
--- a/docs/latest/tutorial/linux-desktop-actions.md
+++ b/docs/latest/tutorial/linux-desktop-actions.md
@@ -1,6 +1,6 @@
 ---
 title: "Desktop Launcher Actions (Linux)"
-description: ""
+description: "On many Linux environments, you can add custom entries to the system launcher by modifying the .desktop file. For Canonical's Unity documentation, see Adding Shortcuts to a Launcher. For details on a more generic implementation, see the freedesktop.org Specification."
 slug: linux-desktop-actions
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/mac-app-store-submission-guide.md b/docs/latest/tutorial/mac-app-store-submission-guide.md
index 58342eb65..e12e92e30 100644
--- a/docs/latest/tutorial/mac-app-store-submission-guide.md
+++ b/docs/latest/tutorial/mac-app-store-submission-guide.md
@@ -224,6 +224,7 @@ By passing `--no-gatekeeper-assess`, the `electron-osx-sign` will skip the macOS
 GateKeeper check as your app usually has not been notarized yet by this step.
 
 <!-- TODO(zcbenz): Add a chapter about App Notarization -->
+
 This guide does not cover [App Notarization][app-notarization], but you might
 want to do it otherwise Apple may prevent users from using your app outside Mac
 App Store.
diff --git a/docs/latest/tutorial/message-ports.md b/docs/latest/tutorial/message-ports.md
index cc2342730..881ae5f65 100644
--- a/docs/latest/tutorial/message-ports.md
+++ b/docs/latest/tutorial/message-ports.md
@@ -138,6 +138,7 @@ app.whenReady().then(async () => {
 
 ```html
 <!-- worker.html ------------------------------------------------------------>
+
 <script>
 const { ipcRenderer } = require('electron')
 
@@ -162,6 +163,7 @@ ipcRenderer.on('new-client', (event) => {
 
 ```html
 <!-- app.html --------------------------------------------------------------->
+
 <script>
 const { ipcRenderer } = require('electron')
 
@@ -306,6 +308,7 @@ ipcRenderer.on('main-world-port', async (event) => {
 
 ```html
 <!-- index.html ------------------------------------------------------------->
+
 <script>
 window.onmessage = (event) => {
   // event.source === window means the message is coming from the preload
diff --git a/docs/latest/tutorial/native-file-drag-drop.md b/docs/latest/tutorial/native-file-drag-drop.md
index 36ef08493..caa9b8a9f 100644
--- a/docs/latest/tutorial/native-file-drag-drop.md
+++ b/docs/latest/tutorial/native-file-drag-drop.md
@@ -1,6 +1,6 @@
 ---
 title: "Native File Drag & Drop"
-description: ""
+description: "Certain kinds of applications that manipulate files might want to support the operating system's native file drag & drop feature. Dragging files into web content is common and supported by many websites. Electron additionally supports dragging files and content out from web content into the operating system's world."
 slug: native-file-drag-drop
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/notifications.md b/docs/latest/tutorial/notifications.md
index bf66c41c1..21a769fc9 100644
--- a/docs/latest/tutorial/notifications.md
+++ b/docs/latest/tutorial/notifications.md
@@ -1,6 +1,6 @@
 ---
 title: "Notifications"
-description: ""
+description: "All three operating systems provide means for applications to send notifications to the user. The technique of showing notifications is different for the Main and Renderer processes."
 slug: notifications
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/offscreen-rendering.md b/docs/latest/tutorial/offscreen-rendering.md
index f644ea282..221afce59 100644
--- a/docs/latest/tutorial/offscreen-rendering.md
+++ b/docs/latest/tutorial/offscreen-rendering.md
@@ -1,6 +1,6 @@
 ---
 title: "Offscreen Rendering"
-description: ""
+description: "Offscreen rendering lets you obtain the content of a BrowserWindow in a bitmap, so it can be rendered anywhere, for example, on texture in a 3D scene. The offscreen rendering in Electron uses a similar approach to that of the Chromium Embedded Framework project."
 slug: offscreen-rendering
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/online-offline-events.md b/docs/latest/tutorial/online-offline-events.md
index 115230cc5..66d46c0ba 100644
--- a/docs/latest/tutorial/online-offline-events.md
+++ b/docs/latest/tutorial/online-offline-events.md
@@ -1,6 +1,6 @@
 ---
 title: "Online/Offline Event Detection"
-description: ""
+description: "Online and offline event detection can be implemented in the Renderer process using the navigator.onLine attribute, part of standard HTML5 API."
 slug: online-offline-events
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/process-model.md b/docs/latest/tutorial/process-model.md
index a8d793295..5df1efba6 100644
--- a/docs/latest/tutorial/process-model.md
+++ b/docs/latest/tutorial/process-model.md
@@ -144,6 +144,7 @@ way to import Electron's content scripts.
 
 <!-- Note: This guide doesn't take sandboxing into account, which might fundamentally 
 change the statements here. -->
+
 Preload scripts contain code that executes in a renderer process before its web content
 begins loading. These scripts run within the renderer context, but are granted more
 privileges by having access to Node.js APIs.
diff --git a/docs/latest/tutorial/progress-bar.md b/docs/latest/tutorial/progress-bar.md
index 976dc7a07..3073a1c95 100644
--- a/docs/latest/tutorial/progress-bar.md
+++ b/docs/latest/tutorial/progress-bar.md
@@ -1,6 +1,6 @@
 ---
 title: "Taskbar Progress Bar (Windows & macOS)"
-description: ""
+description: "A progress bar enables a window to provide progress information to the user without the need of switching to the window itself."
 slug: progress-bar
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/quick-start.md b/docs/latest/tutorial/quick-start.md
index 90bf26bfc..0a1552c70 100644
--- a/docs/latest/tutorial/quick-start.md
+++ b/docs/latest/tutorial/quick-start.md
@@ -137,6 +137,7 @@ folder of your project:
   <head>
     <meta charset="UTF-8">
     <!-- https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP -->
+
     <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self'">
     <meta http-equiv="X-Content-Security-Policy" content="default-src 'self'; script-src 'self'">
     <title>Hello World!</title>
@@ -358,6 +359,7 @@ Electron application that looks like this:
 ![Simplest Electron app](../images/simplest-electron-app.png)
 
 <!--TODO(erickzhao): Remove the individual code blocks for static website -->
+
 The full code is available below:
 
 ```js
@@ -428,11 +430,13 @@ window.addEventListener('DOMContentLoaded', () => {
 ```html
 <!--index.html-->
 
+
 <!DOCTYPE html>
 <html>
   <head>
     <meta charset="UTF-8">
     <!-- https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP -->
+
     <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self'">
     <meta http-equiv="X-Content-Security-Policy" content="default-src 'self'; script-src 'self'">
     <title>Hello World!</title>
@@ -444,6 +448,7 @@ window.addEventListener('DOMContentLoaded', () => {
     and Electron <span id="electron-version"></span>.
 
     <!-- You can also require other files to run in this process -->
+
     <script src="./renderer.js"></script>
   </body>
 </html>
diff --git a/docs/latest/tutorial/recent-documents.md b/docs/latest/tutorial/recent-documents.md
index 66f8bc88e..65ad0cd54 100644
--- a/docs/latest/tutorial/recent-documents.md
+++ b/docs/latest/tutorial/recent-documents.md
@@ -1,6 +1,6 @@
 ---
 title: "Recent Documents (Windows & macOS)"
-description: ""
+description: "Windows and macOS provide access to a list of recent documents opened by the application via JumpList or dock menu, respectively."
 slug: recent-documents
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/represented-file.md b/docs/latest/tutorial/represented-file.md
index 339986bbd..c97792891 100644
--- a/docs/latest/tutorial/represented-file.md
+++ b/docs/latest/tutorial/represented-file.md
@@ -1,6 +1,6 @@
 ---
 title: "Representing Files in a BrowserWindow (macOS)"
-description: ""
+description: "On macOS, you can set a represented file for any window in your application. The represented file's icon will be shown in the title bar, and when users Command-Click or Control-Click, a popup with a path to the file will be shown."
 slug: represented-file
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/sandbox.md b/docs/latest/tutorial/sandbox.md
index 5e7292b51..ae362e20d 100644
--- a/docs/latest/tutorial/sandbox.md
+++ b/docs/latest/tutorial/sandbox.md
@@ -39,6 +39,7 @@ websites, just to name a few. For this reason, we recommend enabling renderer sa
 for the vast majority of cases under an abundance of caution.
 
 <!--TODO: update this guide when #28466 is either solved or closed -->
+
 Note that there is an active discussion in the issue tracker to enable renderer sandboxing
 by default. See [#28466][issue-28466]) for details.
 
@@ -54,6 +55,7 @@ regular Chrome renderer would. A sandboxed renderer won't have a Node.js
 environment initialized.
 
 <!-- TODO(erickzhao): when we have a solid guide for IPC, link it here -->
+
 Therefore, when the sandbox is enabled, renderer processes can only perform privileged
 tasks (such as interacting with the filesystem, making changes to the system, or spawning
 subprocesses) by delegating these tasks to the main process via inter-process
diff --git a/docs/latest/tutorial/security.md b/docs/latest/tutorial/security.md
index c1f01a410..940255093 100644
--- a/docs/latest/tutorial/security.md
+++ b/docs/latest/tutorial/security.md
@@ -147,10 +147,12 @@ browserWindow.loadURL('https://example.com')
 
 ```html
 <!-- Bad -->
+
 <script crossorigin src="http://example.com/react.js"></script>
 <link rel="stylesheet" href="http://example.com/style.css">
 
 <!-- Good -->
+
 <script crossorigin src="https://example.com/react.js"></script>
 <link rel="stylesheet" href="https://example.com/style.css">
 ```
@@ -206,9 +208,11 @@ mainWindow.loadURL('https://example.com')
 
 ```html
 <!-- Bad -->
+
 <webview nodeIntegration src="page.html"></webview>
 
 <!-- Good -->
+
 <webview src="page.html"></webview>
 ```
 
@@ -339,9 +343,11 @@ const mainWindow = new BrowserWindow()
 
 ```html
 <!-- Bad -->
+
 <webview disablewebsecurity src="page.html"></webview>
 
 <!-- Good -->
+
 <webview src="page.html"></webview>
 ```
 
@@ -519,9 +525,11 @@ you know it needs that feature.
 
 ```html
 <!-- Bad -->
+
 <webview allowpopups src="page.html"></webview>
 
 <!-- Good -->
+
 <webview src="page.html"></webview>
 ```
 
diff --git a/docs/latest/tutorial/support.md b/docs/latest/tutorial/support.md
index 711e3b7b7..be225fa94 100644
--- a/docs/latest/tutorial/support.md
+++ b/docs/latest/tutorial/support.md
@@ -1,6 +1,6 @@
 ---
 title: "Electron Support"
-description: ""
+description: "If you have a security concern, please see the security document."
 slug: support
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/tray.md b/docs/latest/tutorial/tray.md
index 7840e454a..b6a5a9bd2 100644
--- a/docs/latest/tutorial/tray.md
+++ b/docs/latest/tutorial/tray.md
@@ -12,6 +12,7 @@ hide_title: true
 
 <!-- ✍ Update this section if you want to provide more details -->
 
+
 This guide will take you through the process of creating a
 [Tray](https://www.electronjs.org/docs/api/tray) icon with
 its own context menu to the system's notification area.
diff --git a/docs/latest/tutorial/web-embeds.md b/docs/latest/tutorial/web-embeds.md
index 087df51c7..3629a31ea 100644
--- a/docs/latest/tutorial/web-embeds.md
+++ b/docs/latest/tutorial/web-embeds.md
@@ -1,6 +1,6 @@
 ---
 title: "Web Embeds"
-description: ""
+description: "If you want to embed (third-party) web content in an Electron BrowserWindow, there are three options available to you: <iframe> tags, <webview> tags, and BrowserViews. Each one offers slightly different functionality and is useful in different situations. To help you choose between these, this guide explains the differences and capabilities of each option."
 slug: web-embeds
 hide_title: false
 ---
diff --git a/docs/latest/tutorial/windows-taskbar.md b/docs/latest/tutorial/windows-taskbar.md
index 8130b9019..568a6c13d 100644
--- a/docs/latest/tutorial/windows-taskbar.md
+++ b/docs/latest/tutorial/windows-taskbar.md
@@ -1,6 +1,6 @@
 ---
 title: "Taskbar Customization (Windows)"
-description: ""
+description: "Electron has APIs to configure the app's icon in the Windows taskbar. This API supports both Windows-only features like creation of a JumpList, custom thumbnails and toolbars, icon overlays, and the so-called \"Flash Frame\" effect, and cross-platform features like recent documents and application progress."
 slug: windows-taskbar
 hide_title: false
 ---