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

@@ -2,7 +2,7 @@
 
 title: xPack {{packageConfig.descriptiveName}} v{{xpackVersion}} released
 seo_title: Version {{xpackVersion}} released
-description: Version {{xpackVersion}} is a TODO new/maintenance release.
+description: Version {{xpackVersion}} is a TODO maintenance/new release.
 keywords:
   - xpack
   - {{packageConfig.permalinkName}}
@@ -35,8 +35,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
@@ -55,13 +55,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).
 
 :::
 
@@ -180,7 +180,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/riscv-none-elf-gcc-xpack/actions/)
-- [Travis CI](https://app.travis-ci.com/github/xpack-dev-tools/riscv-none-elf-gcc-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/riscv-none-elf-gcc-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/riscv-none-elf-gcc-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/riscv-none-elf-gcc-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/_gcc-release-schedule.mdx

@@ -10,11 +10,11 @@ import versionMajor from '@site/src/libs/versionMajor';
 This distribution generally follows the official
 [GCC release](https://gcc.gnu.org/releases.html) timeline.
 
-For each major version there are 2 releases, like **{versionMajor()}.1**
+For each major version there are 2 releases, such as **{versionMajor()}.1**
 in the first part of the year (tentatively April-May) and
 **{versionMajor()}.2** in the second part
-(tentatively in August-September).
+(tentatively August-September).
 
-Previous versions are maintained for 3 more years, and, around midyear,
-GNU releases updates for the previous 3 versions,
-(like **{versionMajor() - 1}.3**, **{versionMajor() - 2}.4**, **{versionMajor() - 3}.5**).
+Previous versions are maintained for 3 additional years, and, around mid-year,
+GNU releases updates for the previous 3 versions
+(such as **{versionMajor() - 1}.3**, **{versionMajor() - 2}.4**, **{versionMajor() - 3}.5**).

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/riscv-none-elf-gcc-xpack.git; npm run generate-top-commons)
+npm run generate-top-commons -C ~/Work/xpack-dev-tools/riscv-none-elf-gcc-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**_