Install: build: various; style

esmerel · esmerel · commit aa7439722714 · 2025-07-28T15:21:26.000-07:00
Signed-off-by: Lynette Miles &lt;lynette.miles@chronosphere.io&gt;
diff --git a/installation/kubernetes.md b/installation/kubernetes.md
@@ -28,7 +28,7 @@ The recommended way to deploy Fluent Bit for Kubernetes is with the official [He
 
 If you are using Red Hat OpenShift you must set up Security Context Constraints (SCC) using the relevant option in the helm chart.
 
-### Installing with Helm Chart
+### Installing with Helm chart
 
 [Helm](https://helm.sh) is a package manager for Kubernetes and lets you deploy application packages into your running cluster. Fluent Bit is distributed using a Helm chart found in the [Fluent Helm Charts repository](https://github.com/fluent/helm-charts).
 
diff --git a/installation/macos.md b/installation/macos.md
@@ -4,7 +4,7 @@ Fluent Bit is compatible with the latest Apple macOS software for x86_64 and App
 
 ## Installation packages
 
-Installation packages can be found [here](https://packages.fluentbit.io/macos/).
+Installation packages can be found [in the Fluent Bit repository](https://packages.fluentbit.io/macos/).
 
 ## Requirements
 
diff --git a/installation/upgrade-notes.md b/installation/upgrade-notes.md
@@ -16,13 +16,13 @@ The `td-agent-bit` package is no longer provided after this release. Users shoul
 
 If you are migrating from previous version of Fluent Bit, review the following important changes:
 
-### Tail Input Plugin
+### Tail input plugin
 
 By default, the tail input plugin follows a file from the end after the service starts, instead of reading it from the beginning. Every file found when the plugin starts is followed from it last position. New files discovered at runtime or when files rotate are read from the beginning.
 
 To keep the old behavior, set the option `read_from_head` to `true`.
 
-### Stackdriver Output Plugin
+### Stackdriver output plugin
 
 The `project_id` of [resource](https://cloud.google.com/logging/docs/reference/v2/rest/v2/MonitoredResource) in [LogEntry](https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry) sent to Google Cloud Logging would be set to the `project_id` rather than the project number. To learn the difference between Project ID and project number, see [Creating and managing projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#before_you_begin).
 
@@ -44,15 +44,15 @@ If you are migrating from Fluent Bit v1.2 to v1.3, there are no breaking changes
 
 ## Fluent Bit v1.2
 
-### Docker, JSON, Parsers and Decoders
+### Docker, JSON, parsers, and decoders
 
 Fluent Bit v1.2 fixed many issues associated with JSON encoding and decoding.
 
 For example, when parsing Docker logs, it's no longer necessary to use decoders. The new Docker parser looks like this:
 
 ```python [PARSER] Name docker Format json Time_Key time Time_Format %Y-%m-%dT%H:%M:%S.%L Time_Keep On ```
 
-### Kubernetes Filter
+### Kubernetes filter
 
 Fluent Bit made improvements to Kubernetes Filter handling of stringified `log` messages. If the `Merge_Log` option is enabled, it will try to handle the log content as a JSON map, if so, it will add the keys to the root map.
 
diff --git a/installation/windows.md b/installation/windows.md
@@ -85,20 +85,20 @@ The latest stable version is 4.0.5. Each version is available from the following
 
 | INSTALLERS | SHA256 CHECKSUMS |
 |----------- | ---------------- |
-| [fluent-bit-4.0.5-win32.exe](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.exe) | [31d1d98f3c9a8cb829abc448de93ef859b63d02852c8529482fe284ed1176356](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.exe.sha256) |
-| [fluent-bit-4.0.5-win32.zip](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.zip) | [98463c4a2d49392a2a01a8942f9ec6096328845c71476b5fd8a6055487101772](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.zip.sha256) |
-| [fluent-bit-4.0.5-win64.exe](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.exe) | [935bc64cd81140e37c3e59aeed65e96a5e2c1e255252d2084754f2e829f04301](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.exe.sha256) |
-| [fluent-bit-4.0.5-win64.zip](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.zip) | [f0c101bfd889c6f327dc74914e6084b77dbad9c9d64fe58a63fddd836aa29fec](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.zip.sha256) |
-| [fluent-bit-4.0.5-winarm64.exe](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.exe) | [be71a4c9ce51d69ea7ae18b32670c377e21039d4543a362ee06cee519e6c5308](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.exe.sha256) |
-| [fluent-bit-4.0.5-winarm64.zip](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.zip) | [b39bfc3901b6da135acdc5fd16ce36ba7c6195efa7c68635815991816c35882e](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.zip.sha256) |
+| [`fluent-bit-4.0.5-win32.exe`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.exe) | [`31d1d98f3c9a8cb829abc448de93ef859b63d02852c8529482fe284ed1176356`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.exe.sha256) |
+| [`fluent-bit-4.0.5-win32.zip`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.zip) | [`98463c4a2d49392a2a01a8942f9ec6096328845c71476b5fd8a6055487101772`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.zip.sha256) |
+| [`fluent-bit-4.0.5-win64.exe`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.exe) | [`935bc64cd81140e37c3e59aeed65e96a5e2c1e255252d2084754f2e829f04301`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.exe.sha256) |
+| [`fluent-bit-4.0.5-win64.zip`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.zip) | [`f0c101bfd889c6f327dc74914e6084b77dbad9c9d64fe58a63fddd836aa29fec`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.zip.sha256) |
+| [`fluent-bit-4.0.5-winarm64.exe`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.exe) | [`be71a4c9ce51d69ea7ae18b32670c377e21039d4543a362ee06cee519e6c5308`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.exe.sha256) |
+| [`fluent-bit-4.0.5-winarm64.zip`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.zip) | [`b39bfc3901b6da135acdc5fd16ce36ba7c6195efa7c68635815991816c35882e`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.zip.sha256) |
 
 These are now using the Github Actions built versions. Legacy AppVeyor builds are still available (AMD 32/64 only) at releases.fluentbit.io but are deprecated.
 
 MSI installers are also available:
 
-- [fluent-bit-4.0.5-win32.msi](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.msi)
-- [fluent-bit-4.0.5-win64.msi](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.msi)
-- [fluent-bit-4.0.5-winarm64.msi](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.msi)
+- [`fluent-bit-4.0.5-win32.msi`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win32.msi)
+- [`fluent-bit-4.0.5-win64.msi`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-win64.msi)
+- [`fluent-bit-4.0.5-winarm64.msi`](https://packages.fluentbit.io/windows/fluent-bit-4.0.5-winarm64.msi)
 
 To check the integrity, use the `Get-FileHash` cmdlet for PowerShell.
 
@@ -164,10 +164,10 @@ Fluent Bit v2.0.x
 
 To halt the process, press `Control+C` in the terminal.
 
-## Installing from the EXE installer
+## Installing from the executable installer
 
-1. Download an EXE installer for the appropriate 32-bit or 64-bit build.
-1. Double-click the EXE installer you've downloaded. The installation wizard starts.
+1. Download an `EXE` installer for the appropriate 32-bit or 64-bit build.
+1. Double-click the `EXE` installer you've downloaded. The installation wizard starts.
 
 1. Click **Next** and finish the installation. By default, Fluent Bit is installed in `C:\Program Files\fluent-bit\`.
 
@@ -189,7 +189,7 @@ The uninstaller also supports a silent uninstall using the same `/S` flag. This
 
 ## Windows service support
 
-Windows services are equivalent to daemons in UNIX (long-running background processes). For v1.5.0 and later, Fluent Bit has native support for Windows services.
+Windows services are equivalent to daemons in Unix (long-running background processes). For v1.5.0 and later, Fluent Bit has native support for Windows services.
 
 For example, you have the following installation layout:
 
@@ -279,7 +279,7 @@ Remove the service (requires PowerShell 6.0 or later)
 Remove-Service fluent-bit
 ```
 
-## Compile from Source
+## Compile from source
 
 If you need to create a custom executable, use the following procedure to compile Fluent Bit by yourself.
 
@@ -294,7 +294,7 @@ start vs.exe
 
 1. Choose `C++ Build Tools` and `C++ CMake tools for Windows` and wait until the process finishes.
 
-1. Install flex and bison. One way to install them on Windows is to use [winflexbison](https://github.com/lexxmark/winflexbison).
+1. Install flex and bison. One way to install them on Windows is to use [`winflexbison`](https://github.com/lexxmark/winflexbison).
 
    ```shell
    wget -o winflexbison.zip https://github.com/lexxmark/winflexbison/releases/download/v2.5.22/win_flex_bison-2.5.22.zip
diff --git a/installation/yocto-embedded-linux.md b/installation/yocto-embedded-linux.md
@@ -6,11 +6,11 @@ Fluent Bit distributes two main recipes, one for testing/dev purposes and one wi
 
 | Version | Recipe | Description |
 | :--- | :--- | :--- |
-| `devel` | [fluent-bit\_git.bb](https://github.com/fluent/fluent-bit/blob/master/fluent-bit_git.bb) | Build Fluent Bit from Git master. Use for development and testing purposes only. |
-| `v1.8.11` | [fluent-bit\_1.8.11.bb](https://github.com/fluent/fluent-bit/blob/v1.8.11/fluent-bit_1.8.11.bb) | Build latest stable version of Fluent Bit. |
+| `devel` | [fluent-bit_git.bb](https://github.com/fluent/fluent-bit/blob/master/fluent-bit_git.bb) | Build Fluent Bit from Git master. Use for development and testing purposes only. |
+| `v1.8.11` | [fluent-bit_1.8.11.bb](https://github.com/fluent/fluent-bit/blob/v1.8.11/fluent-bit_1.8.11.bb) | Build latest stable version of Fluent Bit. |
 
 It's strongly recommended to always use the stable release of the Fluent Bit recipe and not the one from Git master for production deployments.
 
 ## Fluent Bit and other architectures
 
-Fluent Bit &gt;= v1.1.x fully supports `x86_64`, `x86`, `arm32v7`, and `arm64v8`.
+Fluent Bit 1.1.x and later fully supports `x86_64`, `x86`, `arm32v7`, and `arm64v8`.
diff --git a/vale-styles/FluentBit/Acronyms.yml b/vale-styles/FluentBit/Acronyms.yml
@@ -10,6 +10,7 @@ second: '(?:\b[A-Z][a-z]+ )+\(([A-Z]{3,5})\)'
 exceptions:
   - AAD
   - ACL
+  - AMD
   - ANSI
   - API
   - ARN
@@ -57,6 +58,7 @@ exceptions:
   - HTTP
   - HTTPS
   - IAM
+  - IBM
   - IDE
   - IMDS
   - ISO
@@ -72,12 +74,14 @@ exceptions:
   - MIME
   - MAC
   - MQTT
+  - MSI
   - MSK
   - NATS
   - NET
   - NGINX
   - NIC
   - NOTE
+  - NSIS
   - NVDA
   - OAP
   - OOM
diff --git a/vale-styles/FluentBit/Headings.yml b/vale-styles/FluentBit/Headings.yml
@@ -68,6 +68,8 @@ exceptions:
   - Grafana Cloud
   - Graylog Extended Log Format
   - gRPC
+  - Helm
+  - Homebrew
   - HTTP
   - I
   - InfluxDB
@@ -95,8 +97,9 @@ exceptions:
   - OIDC
   - Okta
   - OpenMetrics
-  - OpenSearch
   - OpenObserve
+  - OpenSearch
+  - OpenShift
   - OpenTelemetry
   - Opsgenie
   - Oracle Cloud Infrastructure Logging Analytics
diff --git a/vale-styles/FluentBit/Spelling-exceptions.txt b/vale-styles/FluentBit/Spelling-exceptions.txt
@@ -92,6 +92,7 @@ grpc_service
 gzip
 HashiCorp
 HEC
+Homebrew
 hostname
 Hostname
 Ingester

-Original file line number
+Diff line change
 exceptions:
   - AAD
   - ACL
 +  - AMD
   - ANSI
   - API
   - ARN
   - HTTP
   - HTTPS
   - IAM
 +  - IBM
   - IDE
   - IMDS
   - ISO
   - MIME
   - MAC
   - MQTT
 +  - MSI
   - MSK
   - NATS
   - NET
   - NGINX
   - NIC
   - NOTE
 +  - NSIS
   - NVDA
   - OAP
   - OOM