re-generate website commons

Author: ilg-ul

README.md

@@ -22,6 +22,6 @@ The source code of the current release is available on
 ## License
 
 Unless otherwise stated, the original content is released under the terms of the
-[MIT License](https://opensource.org/licenses/MIT),
+[MIT License](https://opensource.org/licenses/mit),
 with all rights reserved to
 [Liviu Ionescu](https://github.com/ilg-ul).

website/blog/_common/_deprecation-notices-glib-2.27.mdx

@@ -13,7 +13,7 @@ Support for RedHat 7 was dropped in 2022.
 
 ### 32-bit support
 
-Support for 32-bit x86 GNU/Linux and x86 Windows was
+Support for 32-bit x64 GNU/Linux and x64 Windows was
 dropped in 2022.
 
 ### Pre-deprecation notice for 32-bit Arm GNU/Linux

website/blog/_common/_deprecation-notices-glib-2.28.mdx

@@ -14,5 +14,16 @@ Support for Ubuntu 18 was dropped in 2025.
 
 ### 32-bit support
 
-Support for 32-bit x86 GNU/Linux and x86 Windows was
+Support for 32-bit x64 GNU/Linux and x64 Windows was
 dropped in 2022 and for 32-bit Arm GNU/Linux in 2025.
+
+### Pre-deprecation notice for x64 macOS
+
+Apple has discontinued support for the x64 (Intel) architecture.
+GitHub will no longer support this architecture on macOS after the
+macOS 15 runner image is retired in **November 2027**; building
+and testing x64 macOS binaries will become more difficult, requiring
+a self-hosted runner, and cannot be guaranteed in the long term.
+
+You should begin migrating your projects to arm64-based (Apple Silicon)
+binaries to prepare for this possible deprecation.

website/blog/_templates/blog-post-release-part-1-liquid.mdx

@@ -32,8 +32,8 @@ import {PageMetadata} from '@docusaurus/theme-common';
 import Image from '@theme/IdealImage';
 import CodeBlock from '@theme/CodeBlock';
 
-import Prerequisites from './_common/_prerequisites-glib-2.27.mdx';
-import DeprecationNotices from './_common/_deprecation-notices-glib-2.27.mdx';
+import Prerequisites from './_common/_prerequisites-glib-2.28.mdx';
+import DeprecationNotices from './_common/_deprecation-notices-glib-2.28.mdx';
 import DownloadAnalytics from './_common/_download-analytics.mdx';
 
 TODO: select one summary
@@ -52,13 +52,13 @@ is a standalone cross-platform binary distribution of
 
 There are separate binaries for **Windows** (x64),
 **macOS** (x64 and arm64)
-and **GNU/Linux** (x64, arm64 and arm).
+and **GNU/Linux** (x64 and arm64).
 
 :::note Raspberry Pi
 
 The main targets for the GNU/Linux Arm
-binaries are the **Raspberry Pi** class devices (armv7l and aarch64;
-armv6 is not supported).
+binaries are the **Raspberry Pi** class devices (aarch64 only;
+armv6 and armv7l are no longer supported).
 
 :::
 
@@ -170,7 +170,6 @@ Before publishing, a set of simple tests were performed on an exhaustive
 set of platforms. The results are available from:
 
 - [GitHub Actions](https://github.com/xpack-dev-tools/qemu-riscv-xpack/actions/)
-- [Travis CI](https://app.travis-ci.com/github/xpack-dev-tools/qemu-riscv-xpack/builds/)
 
 ## Tests
 

website/docs/_common/_branches-details.mdx

@@ -6,15 +6,15 @@
 <details>
 <summary>Branches</summary>
 
-The project uses multiple branches:
+This project utilises multiple branches:
 
 - `master`, not actively used
-- `xpack`, with the latest stable version (default)
-- `xpack-development`, with the current development version
-- `website`, with the current content of the website; pushes to this branch automatically trigger publishes the main website
-- `development`, with the current content of the preview website; pushes to this branch automatically trigger publishes the preview website
+- `xpack`, containing the latest stable version (default)
+- `xpack-development`, containing the current development version
+- `website`, containing the current website content; pushes to this branch automatically trigger publication of the main website
+- `development`, containing the current preview website content; pushes to this branch automatically trigger publication of the preview website
 
-All development is done in the `xpack-development` branch, and contributions via
+All development is conducted in the `xpack-development` branch, and contributions via
 Pull Requests should be directed to this branch.
 
 When new releases are published, the `xpack-development` branch is merged

website/docs/_common/_build-website-locally.mdx

@@ -5,10 +5,10 @@
 
 ### Build the static website locally
 
-Validate the website content in a local build via the npm **build** script:
+Validate the website content by performing a local build using the npm **build** script:
 
 ```sh
-npm run build -C website
+npm run build -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/website
 ```
 
-Fix any broken links, if any.
+Resolve any broken links that may be identified during the build process.

website/docs/_common/_code-formatting.mdx

@@ -5,24 +5,24 @@
 
 ## Code formatting
 
-As formatting style, the library uses a
+For formatting style, the library employs a
 [.clang-format](https://clang.llvm.org/docs/ClangFormat.html)
 configuration file based on the GNU style.
 
-Code formatting is done using `clang-format --style=file`, either manually
-from a script, or automatically from Visual Studio Code, or the Eclipse
+Code formatting is performed using `clang-format --style=file`, either manually
+via a script, or automatically through Visual Studio Code, or the Eclipse
 CppStyle plug-in.
 
 :::info
 
-Visual Studio Code can directly utilise the `.clang-format` file in the
+Visual Studio Code can directly utilise the `.clang-format` file within the
 **Format Document** command.
 
 :::
 
 :::tip
 
-Always reformat the source files that were changed before committing
+Always reformat the source files that have been modified before committing
 them to the repository.
 
 :::

website/docs/_common/_continuous-integration.mdx

@@ -3,11 +3,13 @@
 
 {/* ------------------------------------------------------------------------ */}
 
-The library is
-CI tested on every push via
-[GitHub Actions](https://github.com/xpack-dev-tools/qemu-riscv-xpack/actions),
-on Ubuntu, macOS, and Windows.
+The library is subject to continuous integration (CI) testing with every
+push utilising [GitHub Actions](https://github.com/xpack-dev-tools/qemu-riscv-xpack/actions).
+This ensures compatibility and stability across Ubuntu, macOS, and Windows
+operating systems.
 
-The tests run on 32 and 64-bit bare-metal platforms (Arm Cortex-M0,
-Cortex-M3, Cortex-M4F, Cortex-M7F, Cortex-A15, Cortex-A72, RISC-V RV32IMAC,
-RV64IMAFDC), and natively, with GCC and LLVM/clang.
+Testing is conducted on both 32-bit and 64-bit bare-metal platforms,
+including Arm Cortex-M0, Cortex-M3, Cortex-M4F, Cortex-M7F, Cortex-A15,
+Cortex-A72, RISC-V RV32IMAC, and RV64IMAFDC. Additionally, native
+testing is performed utilising GCC and LLVM/clang compilers, ensuring
+comprehensive validation across various environments.

website/docs/_common/_generate-top-commons.mdx

@@ -5,14 +5,14 @@
 
 ### Generate the top commons
 
-Run the top **generate-top-commons** npm script to update the
+Execute the top **generate-top-commons** npm script to update the
 `build-assets/package.json` and the GitHub workflow files.
 
 ```sh
-(cd ~/Work/xpack-dev-tools/qemu-riscv-xpack.git; npm run generate-top-commons)
+npm run generate-top-commons -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git
 ```
 
 ### Commit the top changes
 
-- stage GitHub workflows and `package.json` files (top and from `build-assets`)
-- **commit** with the message _**re-generate top commons to bump deps**_
+- Stage GitHub workflows and `package.json` files (top and from `build-assets`)
+- **Commit** with the message _**re-generate top commons**_

website/docs/_common/_generate-website-commons.mdx

@@ -3,11 +3,16 @@
 
 {/* ------------------------------------------------------------------------ */}
 
-### Update the website commons
+### Generate the website commons
 
-Run the **generate-website-commons** npm script from `website/package.json`
-in the project folder.
+Execute the **generate-website-commons** npm script from `website/package.json`
+within the project folder.
 
 ```sh
-npm run generate-website-commons -C website
+npm run generate-website-commons -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/website
 ```
+
+### Commit the website changes
+
+- Stage the `website` folder and top `README.md`
+- **Commit** with the message _**re-generate website commons**_