feat: documentation site redesign

content/_index.md

@@ -24,46 +24,46 @@ smart home exactly how you want it.
 {{< feature-grid >}}
 [
   {
-    "icon": "code",
-    "title": "No Coding Required",
+    "icon": "code-block-tags",
+    "title": "No coding required",
     "description": "Simple YAML configuration files instead of complex C++ code"
   },
   {
-    "icon": "wifi",
-    "title": "Wireless Updates",
+    "icon": "cloud-download",
+    "title": "Wireless updates",
     "description": "Update your devices over-the-air without physical access"
   },
   {
-    "icon": "puzzle-piece",
-    "title": "Modular Design",
+    "icon": "shape-plus",
+    "title": "Modular design",
     "description": "Support for hundreds of sensors, displays, and other components"
   },
   {
-    "icon": "shield-alt",
-    "title": "Local Control",
+    "icon": "wifi-strength-off",
+    "title": "Local control",
     "description": "Devices work locally without cloud dependencies"
   }
 ]
 {{< /feature-grid >}}
 {{< anchor "who-uses-esphome" >}}
 
-## Who Uses ESPHome?
+## Who uses ESPHome?
 
 {{< feature-grid >}}
 [
   {
-    "icon": "user-cog",
-    "title": "DIY Enthusiasts",
+    "icon": "head-cog",
+    "title": "DIY enthusiasts",
     "description": "Create custom sensors, switches, and displays tailored to specific needs"
   },
   {
-    "icon": "home",
-    "title": "Smart Home Hobbyists",
+    "icon": "home-automation",
+    "title": "Smart home hobbyists",
     "description": "Extend their home automation systems with affordable custom devices"
   },
   {
-    "icon": "briefcase",
-    "title": "Professional Integrators",
+    "icon": "account-tie",
+    "title": "Professional integrators",
     "description": "Deploy reliable, locally-controlled smart devices for clients"
   },
   {
@@ -79,7 +79,7 @@ smart home exactly how you want it.
 {{< feature-grid >}}
 [
   {
-    "icon": "microchip",
+    "icon": "espressif",
     "title": "Espressif ESP32 and ESP8266",
     "description": "Wide support for ESP32 and ESP8266 microcontrollers, the heart of many IoT projects."
   },
@@ -89,20 +89,20 @@ smart home exactly how you want it.
     "description": "Support for Raspberry Pi's RP2040 microcontroller."
   },
   {
-    "icon": "bolt",
+    "icon": "chip",
     "title": "Others",
     "description": "Nordic Semiconductor nRF52, Realtek RTL87xx, and Beken BK72xx chips are supported."
   },
   {
-    "icon": "computer",
+    "icon": "monitor",
     "title": "Desktop",
     "description": "Many ESPHome components can be run on a desktop computer using the *host* platform!"
   }
 ]
 {{< /feature-grid >}}
 {{< anchor "getting-started" >}}
 
-## Getting Started
+## Getting started
 
 Getting started with ESPHome is easy. Choose the method that works best for you:
 
@@ -114,23 +114,23 @@ Getting started with ESPHome is easy. Choose the method that works best for you:
     "description": "The easiest way to get started with ESPHome is through the Home Assistant add-on.",
     "steps": [],
     "url": "/guides/getting_started_hassio/",
-    "button_text": "Home Assistant Guide"
+    "button_text": "Home Assistant guide"
   },
   {
     "icon": "terminal",
-    "title": "Command Line",
+    "title": "Command line",
     "description": "For advanced users who prefer working with the command line.",
     "steps": [],
     "url": "/guides/getting_started_command_line/",
-    "button_text": "Command Line Guide"
+    "button_text": "Command line guide"
   },
   {
     "icon": "puzzle-piece",
-    "title": "Ready-Made Projects",
+    "title": "Ready-made projects",
     "description": "Start with a pre-configured project for common use cases.",
     "steps": [],
     "url": "/projects/",
-    "button_text": "Browse Projects"
+    "button_text": "Browse projects"
   }
 ]
 {{< /getting-started-grid >}}

content/components/_index.md

@@ -12,14 +12,13 @@ params:
 This is the top-level ESPHome documentation index. Browse the tables below, use the sidebar menu, or the search
 function to find the information you're looking for.
 
-### Help improve this documentation
-
-If you find any errors in this site, corrections are welcome. You can submit a *Pull Request* (PR) in the
-[GitHub repo](https://github.com/esphome/esphome-docs) with corrections. If you don't know how to create a PR you
-can just use the "Edit this page on GitHub" link on the page in question which will take you to the source file
-for that page.
-
-Alternatively, post in the *Documentation* channel in the [Discord](https://discord.gg/KhAMKrd) server.
+> [!TIP] Help improve this documentation
+> If you find any errors in this site, corrections are welcome. You can submit a *Pull Request* (PR) in the
+> [GitHub repo](https://github.com/esphome/esphome-docs) with corrections. If you don't know how to create a PR you
+> can just use the "Edit this page on GitHub" link on the page in question which will take you to the source file
+> for that page.
+>
+> Alternatively, post in the *Documentation* channel in the [Discord](https://discord.gg/KhAMKrd) server.
 
 ## ESPHome Configuration
 

content/guides/getting_started_hassio.md

@@ -101,8 +101,8 @@ actions you can perform:
   - **Validate**: This will validate the configuration file.
   - **Install**: Opens the Install dialog.
   - **Clean Build Files**: This will delete all of the generated build files; it can help to resolve compile issues
-    should they occur. *This is safe to perform at any time and you should try this before reporting bugs or other
-    issues.*
+    should they occur. _This is safe to perform at any time and you should try this before reporting bugs or other
+    issues._
 
   - **Delete**: This will delete the configuration file.
 

hugo.yaml

@@ -27,31 +27,31 @@ params:
 
 menu:
   main:
-    - name: "Getting Started"
+    - name: "Getting started"
       weight: 10
       identifier: "getting-started"
     - name: "From Home Assistant"
       url: "/guides/getting_started_hassio/"
       weight: 11
       parent: "getting-started"
-    - name: "Using Command Line"
+    - name: "Using command line"
       url: "/guides/getting_started_command_line/"
       weight: 12
       parent: "getting-started"
-    - name: "Ready-Made Projects"
+    - name: "Ready-made projects"
       url: "/projects/"
       weight: 13
       parent: "getting-started"
     - name: "Migrate from Tasmota"
       url: "/guides/migrate_sonoff_tasmota/"
       weight: 14
       parent: "getting-started"
-    - name: "FAQ and Tips"
+    - name: "FAQ and tips"
       url: "/guides/faq/"
       weight: 15
       parent: "getting-started"
 
-    - name: "Next Steps"
+    - name: "Next steps"
       weight: 20
       identifier: "next-steps"
     - name: "Documentation"
@@ -62,19 +62,19 @@ menu:
       url: "/automations/"
       weight: 22
       parent: "next-steps"
-    - name: "Configuration Types"
+    - name: "Configuration types"
       url: "/guides/configuration-types/"
       weight: 23
       parent: "next-steps"
-    - name: "Device Examples"
+    - name: "Device examples"
       url: "https://devices.esphome.io/"
       weight: 24
       parent: "next-steps"
-    - name: "DIY Examples"
+    - name: "DIY examples"
       url: "/guides/diy/"
       weight: 25
       parent: "next-steps"
-    - name: "Sharing ESPHome Devices"
+    - name: "Sharing ESPHome devices"
       url: "/guides/creators/"
       weight: 26
       parent: "next-steps"
@@ -83,7 +83,7 @@ menu:
       weight: 27
       parent: "next-steps"
 
-    - name: "Keeping Up"
+    - name: "Keeping up"
       weight: 30
       identifier: "keeping-up"
     - name: "Changelog"