Enforce Markdown headers are incremental (home-assistant#28158)

Author: frenck

.remarkignore

@@ -3,6 +3,7 @@ _source/developers/credits.markdown
 
 # Third party
 sass/inuitcss/*
+LICENSE.md
 
 # Changelogs are made out of commit messages
 # We don't want to correct them

.remarkrc.js

@@ -12,6 +12,7 @@ var remarkrc = {
     ["frontmatter"],
     ["lint-fenced-code-flag"],
     ["lint-no-shell-dollars"],
+    ["remark-lint-heading-increment"],
     ["remark-lint-heading-style", "atx"],
     [
       "remark-lint-prohibited-strings",

package-lock.json

@@ -7,6 +7,7 @@
     "remark-frontmatter": "^4.0.1",
     "remark-lint": "^9.1.2",
     "remark-lint-fenced-code-flag": "^3.1.2",
+    "remark-lint-heading-increment": "^3.1.2",
     "remark-lint-heading-style": "^3.1.2",
     "remark-lint-no-shell-dollars": "^3.1.2",
     "remark-lint-prohibited-strings": "^3.1.0",

package.json

@@ -18,7 +18,7 @@ At the moment there are no configuration options available for these cards, you
 
 This card will allow you to pick what data to show. Changing it in this card will influence the data in all other cards.
 
-#### Example
+### Example
 ```yaml
 type: energy-date-selection
 ```
@@ -33,7 +33,7 @@ type: energy-date-selection
 The energy usage graph card shows the amount of energy your house has consumed, and from what source this energy came.
 It will also show the amount of energy your have returned to the grid.
 
-#### Example
+### Example
 ```yaml
 type: energy-usage-graph
 ```
@@ -47,7 +47,7 @@ type: energy-usage-graph
 
 The solar production graph card shows the amount of energy your solar panels have produced per source, and if setup and available the forecast of the solar production.
 
-#### Example
+### Example
 ```yaml
 type: energy-solar-graph
 ```
@@ -61,7 +61,7 @@ type: energy-solar-graph
 
 The gas consumption graph card shows the amount of gas consumed per source.
 
-#### Example
+### Example
 
 ```yaml
 type: energy-gas-graph
@@ -76,7 +76,7 @@ type: energy-gas-graph
 
 The water consumption graph card shows the amount of water consumed per source.
 
-#### Example
+### Example
 
 ```yaml
 type: energy-water-graph
@@ -95,7 +95,7 @@ If setup, it will also tell you how many kWh of the energy you got from the grid
 
 If you set `link_dashboard` to `true`, the card will include a link to the energy dashboard.
 
-#### Example
+### Example
 ```yaml
 type: energy-distribution
 link_dashboard: true
@@ -111,7 +111,7 @@ link_dashboard: true
 The energy sources table card shows all your energy sources, and the corresponding amount of energy.
 If setup, it will also show the costs and compensation per source and the total.
 
-#### Example
+### Example
 ```yaml
 type: energy-sources-table
 ```
@@ -125,7 +125,7 @@ type: energy-sources-table
 
 The grid neutrality gauge card represents your energy dependency. If the needle is in the purple, you returned more energy to the grid than you consumed from it. If it's in the blue, you consumed more energy from the grid than you returned.
 
-#### Example
+### Example
 ```yaml
 type: energy-grid-neutrality-gauge
 ```
@@ -139,7 +139,7 @@ type: energy-grid-neutrality-gauge
 
 The solar consumed gauge represents how much of the solar energy was used by your home and was not returned to the grid. If you frequently return a lot, try to conserve this energy by installing a battery or buying an electric car to charge.
 
-#### Example
+### Example
 ```yaml
 type: energy-solar-consumed-gauge
 ```
@@ -153,7 +153,7 @@ type: energy-solar-consumed-gauge
 
 The carbon consumed gauge card represents how much of the energy consumed by your home was generated using non-fossil fuels like solar, wind and nuclear. It includes the solar energy you generated your self.
 
-#### Example
+### Example
 ```yaml
 type: energy-carbon-consumed-gauge
 ```
@@ -167,7 +167,7 @@ type: energy-carbon-consumed-gauge
 
 The self-sufficiency gauge represents how self-sufficient your home is. If you rely on grid imports, this value decreases. You can increase this value by adding more solar capacity or battery storage.
 
-#### Example
+### Example
 ```yaml
 type: energy-self-sufficiency-gauge
 ```
@@ -181,7 +181,7 @@ type: energy-self-sufficiency-gauge
 
 The devices energy graph show the energy usage per device, it is sorted by usage.
 
-#### Example
+### Example
 ```yaml
 type: energy-devices-graph
 ```

source/_dashboards/energy.markdown

@@ -25,7 +25,7 @@ type:
   type: string
 {% endconfiguration %}
 
-#### Example
+### Example
 
 Alternatively, the position of the card can be configured using YAML with the `view_layout` option:
 

source/_dashboards/sidebar.markdown

@@ -20,7 +20,7 @@ If your entity is not supported, or you cannot customize what you need via this
 
 By default, all of your devices will be visible and have a default icon determined by their domain. You can customize the look and feel of your front page by altering some of these parameters. This can be done by overriding attributes of specific entities.
 
-#### Possible values
+### Possible values
 
 {% configuration customize %}
 friendly_name:
@@ -57,7 +57,7 @@ initial_state:
   default: None
 {% endconfiguration %}
 
-#### Device Class
+### Device Class
 
 Device class is currently supported by the following platforms:
 

source/_docs/configuration/customizing-devices.markdown

@@ -4,7 +4,7 @@ Home Assistant can be flashed to an ODROID-N2+ by connecting the device directly
 
 _All these instructions work the same for the ODROID-N2 (non-plus version)._
 
-#### What you will need
+### What you will need
 
 To flash your eMMC using Petitboot and OTG-USB, you will need the following items:
 
@@ -13,7 +13,7 @@ To flash your eMMC using Petitboot and OTG-USB, you will need the following item
 - USB 2.0 to micro-USB cable
 - If your board came in a Home Assistant Blue: No.2 hex key to open the case
 
-#### Enabling SPI boot mode
+### Enabling SPI boot mode
 
 To enable the SPI boot mode:
 
@@ -30,7 +30,7 @@ To enable the SPI boot mode:
 1. Connect a USB keyboard and a monitor (using HDMI) to your ODROID-N2+.
 1. Plug in the power cable to power on the ODROID-N2+.
 
-#### Enabling USB drive mode
+### Enabling USB drive mode
 
 After The ODROID-N2+ is set to SPI boot mode and powered on, it boots into a terminal. To enable the USB drive mode:
 
@@ -59,7 +59,7 @@ This will configure the ODROID-N2+ and OTG to act as a memory card reader:
    ums /dev/mmcblk0
    ```
 
-#### Flashing Home Assistant
+### Flashing Home Assistant
 
 1. Connect the ODROID-N2+ to your PC via the micro-USB port at the front of the ODROID-N2+. 
 1. When the ODROID-N2 is recognized as a USB connected storage device, you can flash the eMMC with [Etcher](https://www.balena.io/etcher/).

source/_includes/common-tasks/flashing_n2_otg.md

@@ -51,7 +51,7 @@ For example, Sao Paulo, Brazil shows a breadcrumb title of `Brazil > Sao Paulo >
 
 When configured, the platform will create three sensors for each air quality standard:
 
-#### Air Quality Index
+### Air Quality Index
 
 - **Description:** This sensor displays a numeric air quality index (AQI), a metric for the overall "health" of the air.
 - **Example Sensor Name:** `sensor.chinese_air_quality_index`
@@ -67,13 +67,13 @@ AQI | Status | Description
 201 - 300 | **Very unhealthy** | Health warnings of emergency conditions. The entire population is more likely to be affected
 301+ | **Hazardous** | Health alert: everyone may experience more serious health effects
 
-#### Air Pollution Level
+### Air Pollution Level
 
 - **Description:** This sensor displays the associated `Status` (from the above table) for the current AQI.
 - **Sample Sensor Name:** `sensor.us_air_pollution_level`
 - **Example Sensor Value:** `Moderate`
 
-#### Main Pollutant
+### Main Pollutant
 
 - **Description:** This sensor displays the pollutant whose value is currently highest.
 - **Sample Sensor Name:** `sensor.us_main_pollutant`

source/_integrations/airvisual.markdown

@@ -200,31 +200,31 @@ Available services:
 `start_tour`, `stop_tour`, and
 `ptz_control`
 
-#### Service `enable_audio`/`disable_audio`
+### Service `enable_audio`/`disable_audio`
 
 These services enable or disable the camera's audio stream.
 
 Service data attribute | Optional | Description
 -|-|-
 `entity_id` | no | The entity ID of the camera to control. May be a list of multiple entity IDs. To target all cameras, set entity ID to `all`.
 
-#### Service `enable_motion_recording`/`disable_motion_recording`
+### Service `enable_motion_recording`/`disable_motion_recording`
 
 These services enable or disable the camera to record a clip to its configured storage location when motion is detected.
 
 Service data attribute | Optional | Description
 -|-|-
 `entity_id` | no | The entity ID of the camera to control. May be a list of multiple entity IDs. To target all cameras, set entity ID to `all`.
 
-#### Service `enable_recording`/`disable_recording`
+### Service `enable_recording`/`disable_recording`
 
 These services enable or disable the camera to continuously record to its configured storage location.
 
 Service data attribute | Optional | Description
 -|-|-
 `entity_id` | no | The entity ID of the camera to control. May be a list of multiple entity IDs. To target all cameras, set entity ID to `all`.
 
-#### Service `goto_preset`
+### Service `goto_preset`
 
 This service will cause the camera to move to one of the PTZ locations configured within the camera.
 
@@ -233,7 +233,7 @@ Service data attribute | Optional | Description
 `entity_id` | no | The entity ID of the camera to control. May be a list of multiple entity IDs. To target all cameras, set entity ID to `all`.
 `preset` | no | Preset number, starting from 1.
 
-#### Service `set_color_bw`
+### Service `set_color_bw`
 
 This service will set the color mode of the camera.
 
@@ -242,15 +242,15 @@ Service data attribute | Optional | Description
 `entity_id` | no | The entity ID of the camera to control. May be a list of multiple entity IDs. To target all cameras, set entity ID to `all`.
 `color_bw` | no | One of `auto`, `bw` or `color`.
 
-#### Service `start_tour`/`stop_tour`
+### Service `start_tour`/`stop_tour`
 
 These services start or stop the camera's PTZ tour function.
 
 Service data attribute | Optional | Description
 -|-|-
 `entity_id` | no | The entity ID of the camera to control. May be a list of multiple entity IDs. To target all cameras, set entity ID to `all`.
 
-#### Service `ptz_control`
+### Service `ptz_control`
 
 If your Amcrest or Dahua camera supports PTZ, you will be able to pan, tilt or zoom your camera.  
 
@@ -260,12 +260,12 @@ Service data attribute | Optional | Description
  `movement` | no | Direction of the movement. Allowed values: `zoom_in`, `zoom_out`, `up`, `down`, `left`, `right`, `right_up`, `right_down`, `left_up`,  `left_down`
  `travel_time` | yes |Travel time in fractional seconds. Allowed values: `0` to `1`. Default: `0.2`.
 
-#### Notes
+## Notes
 
 - PTZ zoom capability does not control VariFocal lens adjustments.
 - There can be several seconds of lag before the video (snapshot or live) reflects the camera movement.
 
-### Example card with controls
+## Example card with controls
 
 <p class='img'>
   <img src='/images/integrations/amcrest/amcrest_ptz.jpg' alt='Screenshot using a picture-elements with PTZ controls.'>