From a22b8abd533184cddc92e6b71c313902dd7e60ea Mon Sep 17 00:00:00 2001 From: George Kiagiadakis Date: Fri, 4 Sep 2026 16:16:02 +0300 Subject: [PATCH 1/3] Refresh the homepage copy Replace 2000s-era messaging in the hero, features, modules and footer: drop the SMP-safe, multithreading and Linux 2.6 kernel claims, and name LE, ISO and the daemons and tools the page never mentioned. Capability detail is left to the profiles section. --- content/_index.md | 2 +- data/features.yaml | 16 ++++++++-------- data/footer_links.yaml | 4 ++-- data/modules.yaml | 12 ++++++------ hugo.toml | 2 +- 5 files changed, 18 insertions(+), 18 deletions(-) diff --git a/content/_index.md b/content/_index.md index edc4b44..576c1a7 100644 --- a/content/_index.md +++ b/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." --- diff --git a/data/features.yaml b/data/features.yaml index 7b5df61..a324c7f 100644 --- a/data/features.yaml +++ b/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" diff --git a/data/footer_links.yaml b/data/footer_links.yaml index c0f147b..f397f99 100644 --- a/data/footer_links.yaml +++ b/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" diff --git a/data/modules.yaml b/data/modules.yaml index 55820a7..f26fcc9 100644 --- a/data/modules.yaml +++ b/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" diff --git a/hugo.toml b/hugo.toml index c9fbb34..874b619 100644 --- a/hugo.toml +++ b/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] From 15ed4aa5d60f6fbf1018a55c4b91edc574e562b0 Mon Sep 17 00:00:00 2001 From: George Kiagiadakis Date: Fri, 4 Sep 2026 16:24:56 +0300 Subject: [PATCH 2/3] Give each page its own meta description Fall back from a page description to its summary to the site default, so news posts no longer all advertise the homepage text. --- content/news/_index.md | 1 + layouts/partials/head.html | 5 ++++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/content/news/_index.md b/content/news/_index.md index 8a8b8b6..046eaf7 100644 --- a/content/news/_index.md +++ b/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." --- diff --git a/layouts/partials/head.html b/layouts/partials/head.html index 657d603..6514283 100644 --- a/layouts/partials/head.html +++ b/layouts/partials/head.html @@ -1,7 +1,10 @@ {{ .Site.Title }} - +{{- $desc := .Site.Params.description -}} +{{- with .Params.description }}{{ $desc = . }} +{{- else }}{{ with .Params.summary }}{{ $desc = . }}{{ end }}{{ end -}} + {{/* CSS via Hugo Pipes */}} {{ $css := resources.Get "css/main.css" | minify | fingerprint }} From 4864f72251d2d67456d83d781d311da507510497 Mon Sep 17 00:00:00 2001 From: George Kiagiadakis Date: Fri, 4 Sep 2026 16:25:33 +0300 Subject: [PATCH 3/3] Give each page its own title Suffix non-home page titles with the short brand rather than repeating the full site title on every news post. --- layouts/partials/head.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/layouts/partials/head.html b/layouts/partials/head.html index 6514283..ab34083 100644 --- a/layouts/partials/head.html +++ b/layouts/partials/head.html @@ -1,6 +1,6 @@ -{{ .Site.Title }} +{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ .Title }} | BlueZ{{ end }} {{- $desc := .Site.Params.description -}} {{- with .Params.description }}{{ $desc = . }} {{- else }}{{ with .Params.summary }}{{ $desc = . }}{{ end }}{{ end -}}