Improve the website messaging

content/_index.md

@@ -1,5 +1,5 @@
 ---
 title: "BlueZ - Official Linux Bluetooth Protocol Stack"
 heroTitle: "Official Linux Bluetooth Protocol Stack"
-heroText: "The Bluetooth wireless technology is a worldwide specification for a small-form factor, low-cost radio solution that provides links between mobile computers, mobile phones, other portable handheld devices, and connectivity to the Internet. The specification is developed, published and promoted by the Bluetooth Special Interest Group (SIG)."
+heroText: "BlueZ is the Bluetooth stack that ships with Linux. Part of the mainline kernel since 2001 and developed alongside it, it runs on millions of Linux systems: laptops, vehicles, medical equipment, gaming handhelds and embedded products of every kind."
 ---

content/news/_index.md

@@ -1,3 +1,4 @@
 ---
 title: "All the latest news and insight"
+description: "Releases, development updates and weekly reports from the linux-bluetooth mailing list."
 ---

data/features.yaml

@@ -1,9 +1,9 @@
-intro: "**BlueZ** provides support for the core Bluetooth layers and protocols. It is flexible, efficient and uses a modular implementation. It has many interesting features:"
+intro: "**BlueZ** implements the full Bluetooth protocol stack, from the core radio protocols up to the profiles that applications use. It is modular, maintained upstream with the Linux kernel, and provides:"
 items:
-  - "Complete modular implementation"
-  - "Symmetric multi processing safe"
-  - "Multithreaded data processing"
-  - "Support for multiple Bluetooth devices"
-  - "Real hardware abstraction"
-  - "Standard socket interface to all layers"
-  - "Device and service level security support"
+  - "Classic Bluetooth (BR/EDR) and Low Energy in a single stack"
+  - "Standard socket interface to every protocol layer"
+  - "D-Bus APIs for application and system integration"
+  - "Profiles implementable by external programs, as PipeWire does for audio"
+  - "Support for multiple adapters on one system"
+  - "Broad controller support over USB, UART, SDIO and PCIe"
+  - "Device and service level security, including LE Secure Connections"

data/footer_links.yaml

@@ -1,6 +1,6 @@
 columns:
-  - heading: "Download"
-    description: "The current modules of BlueZ are included in the Linux 2.6 kernel series. It is always a good idea to use the latest stable kernel. Kernel modules are in the Linux kernel since 2.4.6 release."
+  - heading: "Source"
+    description: "BlueZ ships in every major Linux distribution, so most people never need to build it themselves. The userspace source is on GitHub. Kernel changes go through the linux-bluetooth mailing list."
     url: "https://github.com/bluez/bluez"
     link_text: "BlueZ on GitHub"
     icon: "github"

data/modules.yaml

@@ -1,7 +1,7 @@
-heading: "Currently **BlueZ** consists of many separate modules:"
+heading: "**BlueZ** consists of several independent modules:"
 items:
-  - "Bluetooth kernel subsystem core (including L2CAP, SCO and RFCOMM)"
-  - "HCI UART, USB, PCI-E and virtual adapter drivers"
-  - "System daemon with D-Bus APIs for access and integration"
-  - "Configuration and testing utilities"
-  - "Protocol decoding and analysis tools"
+  - "Kernel subsystem with L2CAP, SCO, RFCOMM and ISO channels"
+  - "btusb, hci_uart, btsdio, vhci and many vendor-specific drivers"
+  - "bluetoothd, the system daemon exposing the D-Bus API"
+  - "bluetooth-meshd and obexd for mesh and object exchange"
+  - "bluetoothctl, btmgmt and btmon for control and analysis"

hugo.toml

@@ -3,7 +3,7 @@ languageCode = 'en-us'
 title = 'BlueZ - Official Linux Bluetooth Protocol Stack'
 
 [params]
-  description = 'BlueZ is the official Linux Bluetooth protocol stack. It is flexible, efficient and uses a modular implementation.'
+  description = 'BlueZ is the official Linux Bluetooth protocol stack. Part of the mainline kernel, it supports Classic Bluetooth and Low Energy with D-Bus and socket APIs.'
   copyrightYearStart = 2000
 
 [pagination]

layouts/partials/head.html

@@ -1,7 +1,10 @@
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>{{ .Site.Title }}</title>
-<meta name="description" content="{{ .Site.Params.description }}">
+<title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ .Title }} | BlueZ{{ end }}</title>
+{{- $desc := .Site.Params.description -}}
+{{- with .Params.description }}{{ $desc = . }}
+{{- else }}{{ with .Params.summary }}{{ $desc = . }}{{ end }}{{ end -}}
+<meta name="description" content="{{ $desc | plainify | chomp | truncate 155 }}">
 
 {{/* CSS via Hugo Pipes */}}
 {{ $css := resources.Get "css/main.css" | minify | fingerprint }}