Revert "docs: remove useless front matter (facebook#7518)"

This reverts commit ab566ec.

website/docs/api/docusaurus.config.js.md

@@ -1,5 +1,6 @@
 ---
 sidebar_position: 0
+id: docusaurus.config.js
 description: API reference for Docusaurus configuration file.
 slug: /api/docusaurus-config
 ---

website/docs/api/misc/create-docusaurus.md

@@ -1,10 +1,9 @@
 ---
 sidebar_position: 0
-slug: /api/misc/create-docusaurus
+title: '📦 create-docusaurus'
+slug: '/api/misc/create-docusaurus'
 ---
 
-# 📦 create-docusaurus
-
 A scaffolding utility to help you instantly set up a functional Docusaurus app.
 
 ## Usage {#usage}

website/docs/api/misc/eslint-plugin/README.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 1
-slug: /api/misc/@docusaurus/eslint-plugin
+id: eslint-plugin
+title: '📦 eslint-plugin'
+slug: '/api/misc/@docusaurus/eslint-plugin'
 ---
 
-# 📦 eslint-plugin
-
 [ESLint](https://eslint.org/) is a tool that statically analyzes your code and reports problems or suggests best practices through editor hints and command line. Docusaurus provides an ESLint plugin to enforce best Docusaurus practices.
 
 ## Installation

website/docs/api/misc/eslint-plugin/no-untranslated-text.md

@@ -1,11 +1,9 @@
 ---
-slug: /api/misc/@docusaurus/eslint-plugin/no-untranslated-text
+slug: '/api/misc/@docusaurus/eslint-plugin/no-untranslated-text'
 ---
 
 # no-untranslated-text
 
-import APITable from '@site/src/components/APITable';
-
 Enforce text labels in JSX to be wrapped by translate calls.
 
 When the [i18n feature](../../../i18n/i18n-introduction.md) is used, this rule ensures that all labels appearing on the website are translatable, so no string accidentally slips through untranslated.

website/docs/api/misc/eslint-plugin/string-literal-i18n-messages.md

@@ -1,5 +1,5 @@
 ---
-slug: /api/misc/@docusaurus/eslint-plugin/string-literal-i18n-messages
+slug: '/api/misc/@docusaurus/eslint-plugin/string-literal-i18n-messages'
 ---
 
 # string-literal-i18n-messages

website/docs/api/misc/logger/logger.md

@@ -1,10 +1,9 @@
 ---
 sidebar_position: 2
-slug: /api/misc/@docusaurus/logger
+title: '📦 logger'
+slug: '/api/misc/@docusaurus/logger'
 ---
 
-# 📦 logger
-
 An encapsulated logger for semantically formatting console messages.
 
 Authors of packages in the Docusaurus ecosystem are encouraged to use this package to provide unified log formats.

website/docs/api/plugins/overview.md

@@ -1,12 +1,11 @@
 ---
 sidebar_position: 0
 id: plugins-overview
+title: 'Docusaurus plugins'
 sidebar_label: Plugins overview
-slug: /api/plugins
+slug: '/api/plugins'
 ---
 
-# Docusaurus plugins
-
 We provide official Docusaurus plugins.
 
 ## Content plugins {#content-plugins}

website/docs/api/plugins/plugin-client-redirects.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 4
-slug: /api/plugins/@docusaurus/plugin-client-redirects
+id: plugin-client-redirects
+title: '📦 plugin-client-redirects'
+slug: '/api/plugins/@docusaurus/plugin-client-redirects'
 ---
 
-# 📦 plugin-client-redirects
-
 import APITable from '@site/src/components/APITable';
 
 Docusaurus Plugin to generate **client-side redirects**.

website/docs/api/plugins/plugin-content-blog.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 2
-slug: /api/plugins/@docusaurus/plugin-content-blog
+id: plugin-content-blog
+title: '📦 plugin-content-blog'
+slug: '/api/plugins/@docusaurus/plugin-content-blog'
 ---
 
-# 📦 plugin-content-blog
-
 import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.

website/docs/api/plugins/plugin-content-docs.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 1
-slug: /api/plugins/@docusaurus/plugin-content-docs
+id: plugin-content-docs
+title: '📦 plugin-content-docs'
+slug: '/api/plugins/@docusaurus/plugin-content-docs'
 ---
 
-# 📦 plugin-content-docs
-
 import APITable from '@site/src/components/APITable';
 
 Provides the [Docs](../../guides/docs/docs-introduction.md) functionality and is the default docs plugin for Docusaurus.

website/docs/api/plugins/plugin-content-pages.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 3
-slug: /api/plugins/@docusaurus/plugin-content-pages
+id: plugin-content-pages
+title: '📦 plugin-content-pages'
+slug: '/api/plugins/@docusaurus/plugin-content-pages'
 ---
 
-# 📦 plugin-content-pages
-
 import APITable from '@site/src/components/APITable';
 
 The default pages plugin for Docusaurus. The classic template ships with this plugin with default configurations. This plugin provides [creating pages](guides/creating-pages.md) functionality.

website/docs/api/plugins/plugin-debug.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 5
-slug: /api/plugins/@docusaurus/plugin-debug
+id: plugin-debug
+title: '📦 plugin-debug'
+slug: '/api/plugins/@docusaurus/plugin-debug'
 ---
 
-# 📦 plugin-debug
-
 ```mdx-code-block
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';

website/docs/api/plugins/plugin-google-analytics.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 6
-slug: /api/plugins/@docusaurus/plugin-google-analytics
+id: plugin-google-analytics
+title: '📦 plugin-google-analytics'
+slug: '/api/plugins/@docusaurus/plugin-google-analytics'
 ---
 
-# 📦 plugin-google-analytics
-
 import APITable from '@site/src/components/APITable';
 
 The default [Google Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) plugin. It is a JavaScript library for measuring how users interact with your website **in the production build**. If you are using Google Analytics 4 you might need to consider using [plugin-google-gtag](./plugin-google-gtag.md) instead.

website/docs/api/plugins/plugin-google-gtag.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 7
-slug: /api/plugins/@docusaurus/plugin-google-gtag
+id: plugin-google-gtag
+title: '📦 plugin-google-gtag'
+slug: '/api/plugins/@docusaurus/plugin-google-gtag'
 ---
 
-# 📦 plugin-google-gtag
-
 import APITable from '@site/src/components/APITable';
 
 The default [Global Site Tag (gtag.js)](https://developers.google.com/analytics/devguides/collection/gtagjs/) plugin. It is a JavaScript tagging framework and API that allows you to send event data to Google Analytics, Google Ads, and Google Marketing Platform. This section describes how to configure a Docusaurus site to enable global site tag for Google Analytics.

website/docs/api/plugins/plugin-ideal-image.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 8
-slug: /api/plugins/@docusaurus/plugin-ideal-image
+id: plugin-ideal-image
+title: '📦 plugin-ideal-image'
+slug: '/api/plugins/@docusaurus/plugin-ideal-image'
 ---
 
-# 📦 plugin-ideal-image
-
 import APITable from '@site/src/components/APITable';
 
 Docusaurus Plugin to generate an almost ideal image (responsive, lazy-loading, and low quality placeholder).

website/docs/api/plugins/plugin-pwa.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 9
-slug: /api/plugins/@docusaurus/plugin-pwa
+id: plugin-pwa
+title: '📦 plugin-pwa'
+slug: '/api/plugins/@docusaurus/plugin-pwa'
 ---
 
-# 📦 plugin-pwa
-
 Docusaurus Plugin to add PWA support using [Workbox](https://developers.google.com/web/tools/workbox). This plugin generates a [Service Worker](https://developers.google.com/web/fundamentals/primers/service-workers) in production build only, and allows you to create fully PWA-compliant documentation site with offline and installation support.
 
 ## Installation {#installation}

website/docs/api/plugins/plugin-sitemap.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 10
-slug: /api/plugins/@docusaurus/plugin-sitemap
+id: plugin-sitemap
+title: '📦 plugin-sitemap'
+slug: '/api/plugins/@docusaurus/plugin-sitemap'
 ---
 
-# 📦 plugin-sitemap
-
 import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.

website/docs/api/themes/overview.md

@@ -1,12 +1,11 @@
 ---
 sidebar_position: 0
 id: themes-overview
+title: 'Docusaurus themes'
 sidebar_label: Themes overview
-slug: /api/themes
+slug: '/api/themes'
 ---
 
-# Docusaurus themes
-
 We provide official Docusaurus themes.
 
 ## Main themes {#main-themes}

website/docs/api/themes/theme-classic.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 2
-slug: /api/themes/@docusaurus/theme-classic
+id: theme-classic
+title: '📦 theme-classic'
+slug: '/api/themes/@docusaurus/theme-classic'
 ---
 
-# 📦 theme-classic
-
 The classic theme for Docusaurus.
 
 You can refer to the [theme configuration page](theme-configuration.md) for more details on the configuration.

website/docs/api/themes/theme-configuration.md

@@ -1,12 +1,12 @@
 ---
 sidebar_position: 1
-sidebar_label: Configuration
-slug: /api/themes/configuration
+id: theme-configuration
+title: 'Theme configuration'
+sidebar_label: 'Configuration'
+slug: '/api/themes/configuration'
 toc_max_heading_level: 4
 ---
 
-# Theme configuration
-
 import APITable from '@site/src/components/APITable';
 
 This configuration applies to all [main themes](./overview.md).

website/docs/api/themes/theme-live-codeblock.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 3
-slug: /api/themes/@docusaurus/theme-live-codeblock
+id: theme-live-codeblock
+title: '📦 theme-live-codeblock'
+slug: '/api/themes/@docusaurus/theme-live-codeblock'
 ---
 
-# 📦 theme-live-codeblock
-
 This theme provides a `@theme/CodeBlock` component that is powered by react-live. You can read more on [interactive code editor](../../guides/markdown-features/markdown-features-code-blocks.mdx#interactive-code-editor) documentation.
 
 ```bash npm2yarn

website/docs/api/themes/theme-search-algolia.md

@@ -1,10 +1,10 @@
 ---
 sidebar_position: 4
-slug: /api/themes/@docusaurus/theme-search-algolia
+id: theme-search-algolia
+title: '📦 theme-search-algolia'
+slug: '/api/themes/@docusaurus/theme-search-algolia'
 ---
 
-# 📦 theme-search-algolia
-
 This theme provides a `@theme/SearchBar` component that integrates with Algolia DocSearch easily. Combined with `@docusaurus/theme-classic`, it provides a very easy search integration. You can read more on [search](../../search.md) documentation.
 
 ```bash npm2yarn

website/docs/blog.mdx

@@ -1,13 +1,12 @@
 ---
-description: Deploy a full-featured blog in no time with Docusaurus.
+id: blog
+title: Blog
 ---
 
-# Blog
-
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-The blog feature enables you to deploy a full-featured blog in no time.
+The blog feature enables you to deploy in no time a full-featured blog.
 
 :::info
 

website/docs/browser-support.md

@@ -1,9 +1,8 @@
 ---
-description: How to keep a reasonable bundle size while ensuring sufficient browser support.
+id: browser-support
+title: Browser support
 ---
 
-# Browser support
-
 Docusaurus allows sites to define the list of supported browsers through a [browserslist configuration](https://github.com/browserslist/browserslist).
 
 ## Purpose {#purpose}

website/docs/cli.md

@@ -1,5 +1,5 @@
 ---
-description: Docusaurus provides a set of scripts to help you generate, serve, and deploy your website.
+id: cli
 ---
 
 # CLI

website/docs/configuration.md

@@ -1,9 +1,8 @@
 ---
-description: Configuring your site's behavior through docusaurus.config.js and more.
+id: configuration
+title: Configuration
 ---
 
-# Configuration
-
 import TOCInline from '@theme/TOCInline';
 
 Docusaurus has a unique take on configurations. We encourage you to congregate information about your site into one place. We guard the fields of this file and facilitate making this data object accessible across your site.

website/docs/deployment.mdx

@@ -1,9 +1,8 @@
 ---
-description: Deploy your Docusaurus app for production on a range of static site hosting services.
+id: deployment
+title: Deployment
 ---
 
-# Deployment
-
 To build the static files of your website for production, run:
 
 ```bash npm2yarn

website/docs/docusaurus-core.md

@@ -1,9 +1,9 @@
 ---
+id: docusaurus-core
+title: Docusaurus Client API
 sidebar_label: Client API
 ---
 
-# Docusaurus Client API
-
 Docusaurus provides some APIs on the clients that can be helpful to you when building your site.
 
 ## Components {#components}

website/docs/guides/creating-pages.md

@@ -1,10 +1,10 @@
 ---
+id: creating-pages
+title: Creating Pages
 slug: /creating-pages
 sidebar_label: Pages
 ---
 
-# Creating Pages
-
 In this section, we will learn about creating pages in Docusaurus.
 
 The `@docusaurus/plugin-content-pages` plugin empowers you to create **one-off standalone pages** like a showcase page, playground page, or support page. You can use React components, or Markdown.

website/docs/guides/docs/docs-create-doc.mdx

@@ -1,11 +1,10 @@
 ---
 id: create-doc
+title: Create a doc
 description: Create a Markdown Document
 slug: /create-doc
 ---
 
-# Create a doc
-
 Create a Markdown file, `greeting.md`, and place it under the `docs` directory.
 
 ```bash