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

Author: frenck

Diff for: .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

Diff for: .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",

Diff for: 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",

Diff for: 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
 ```

Diff for: 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:
 

Diff for: 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:
 

Diff for: 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/).

Diff for: 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`

Diff for: 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.'>

Diff for: source/_integrations/amcrest.markdown

@@ -54,7 +54,7 @@ See [Automation Example](#automation-example) section below for details on how t
 Events will not be received in Home Assistant until a schedule is defined via the DoorBird app.
 </div>
 
-#### Clearing Registered Events
+### Clearing Registered Events
 Events can be cleared from DoorBird devices by visiting a special URL.
 
 Simply open a new browser window and navigate to `{Home Assistant URL}/api/doorbird/clear?token={DEVICE_TOKEN}`. Replace `{Home Assistant URL}` with the full path to your running instance, such as `
@@ -64,7 +64,7 @@ Please note that clearing device events will require configuration steps above t
 <br><br>
 If DoorBird was setup using UI prompts, a token can be discovered through DoorBird App by clicking settings (cog icon) -> Administration-> LOGIN (using your App Administration details). Under the "FAVORITES" section, choose "HTTP(S) Calls". This displays all events and the associated HTTP URL. In that URL field, you will be able to see the token that was auto-generated by Home Assistant.
 
-#### Event Data
+### Event Data
 
 Each event will include live image and video URLs for the DoorBird device that triggered the event. These URLs can be found on the event data and are helpful in automation actions. For example, you could use `html5_viewer_url` on a notification to be linked directly to the live view of the device that triggered the automation.
 
@@ -80,7 +80,7 @@ The following keys are available on `event_data`:
 The URLs on the event will be based on the configuration used to connect to your DoorBird device. The ability to connect from outside your network will depend on your configuration.
 </div>
 
-#### Schedules
+## Schedules
 
 Once events have been registered on the DoorBird device, they must be attached to a schedule using the official DoorBird app on Android or iOS or the [DoorBird - WebAdmin](https://webadmin.doorbird.com) portal. Currently, there are schedules available for doorbell, motion, relay, and RFID events (on supported DoorBird devices). Essentially, you can enable an HTTP(S) call from your DoorBird device to the Home Assistant DoorBird API by configuring an action/event (by enabling a schedule).
 
@@ -98,7 +98,7 @@ On the desired event, you should be able to specify blocks of time for when you
 
 Note: Remember to complete the schedule assignment steps above for each event type you registered. If you are configuring HTTP Call(s) schedules for registered RFID tags, please note that you will have to enable/configure the schedule for each RFID tag.
 
-### Automation Example
+## Automation Example
 
 The example automation below shows how to turn on a light when somebody presses the DoorBird call button:
 

Diff for: source/_integrations/doorbird.markdown

@@ -58,7 +58,7 @@ manual:
   type: boolean
 {% endconfiguration %}
 
-#### Time period dictionary example
+### Time period dictionary example
 
 ```yaml
 scan_interval:
@@ -70,7 +70,7 @@ scan_interval:
   milliseconds: 0
 ```
 
-### Service
+## Service
 
 Once loaded, the `fastdotcom` integration will expose a service (`fastdotcom.speedtest`) that can be called to run a Fast.com speed test on demand. This service takes no parameters. This can be useful if you have enabled manual mode.
 

Diff for: source/_integrations/fastdotcom.markdown

@@ -64,7 +64,7 @@ Start an activity. Will start the default `activity` from `configuration.yaml` i
 | `entity_id`            |       no | Entity ID to target.
 | `activity`             |      yes | Activity ID or Activity Name to start.
 
-##### Example
+#### Example
 
 In the file 'harmony_REMOTENAME.conf' you can find the available activities, for example: