website: re-generate commons

Author: 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}}
@@ -31,9 +31,13 @@ download_url: https://github.com/xpack-dev-tools/bash-xpack/releases/tag/v{{xpac
 import {PageMetadata} from '@docusaurus/theme-common';
 import Image from '@theme/IdealImage';
 import CodeBlock from '@theme/CodeBlock';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
-import Prerequisites from './_common/_prerequisites-glib-2.27.mdx';
-import DeprecationNotices from './_common/_deprecation-notices-glib-2.27.mdx';
+import customField from '@site/src/libs/customField';
+
+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';
 
 Version **{{releaseVersion}}** is a new release; it follows the upstream release."
@@ -48,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).
 
 :::
 
@@ -127,7 +131,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/bash-xpack/actions/)
-- [Travis CI](https://app.travis-ci.com/github/xpack-dev-tools/bash-xpack/builds/)
 
 ## Tests
 

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

@@ -1,4 +1,78 @@
 
+## Folders hierarchy
+
+After install, the package creates a hierarchy of folders like the following
+(only the first two depth levels are shown):
+
+{%- assign platforms_array = platforms | split: "," %}
+
+{%- assign names_array = "" | split: "" %}
+
+{%- for platform in platforms_array %}
+{%- case platform %}
+{%- when "win32-x64" %}
+{%- assign names_array = names_array | concat: "Windows" %}
+{%- when "darwin-x64", "darwin-arm64" %}
+{%- assign names_array = names_array | concat: "macOS" %}
+{%- when "linux-x64", "linux-arm64", "linux-arm" %}
+{%- assign names_array = names_array | concat: "GNU/Linux" %}
+{%- endcase %}
+{%- endfor %}
+
+{%- assign names_array = names_array | uniq %}
+
+<Tabs groupId="operating-systems">
+
+{%- for name in names_array %}
+{%- case name %}
+{%- when "Windows" %}
+
+<TabItem value="windows" label="Windows" default>
+
+<CodeBlock language="console"> {
+`C:\> tree /f %USERPROFILE%\\AppData\\Roaming\\xPacks\\@{{packageScope}}\\{{packageName}}\\${frontMatter.version}.${frontMatter.npm_subversion}\\.content
+Folder PATH listing
+Volume serial number is B02D-925C
+├── README.md
+├── bin
+TODO
+`} </CodeBlock>
+
+</TabItem>
+
+{%- when "macOS" %}
+
+<TabItem value="macos" label="macOS">
+
+<CodeBlock language="console"> {
+`$ tree -L 2 ~/Library/xPacks/\{{packageScopedName}}/${frontMatter.version}.${frontMatter.npm_subversion}/.content/
+/Users/ilg/Library/xPacks/\{{packageScopedName}}/${frontMatter.version}.${frontMatter.npm_subversion}/.content/
+├── README.md
+├── bin
+TODO
+`} </CodeBlock>
+
+</TabItem>
+
+{%- when "GNU/Linux" %}
+
+<TabItem value="linux" label="GNU/Linux">
+
+<CodeBlock language="console"> {
+`$ tree -L 2 ~/.local/xPacks/\{{packageScopedName}}/${frontMatter.version}.${frontMatter.npm_subversion}/.content/
+/home/ilg/.local/xPacks/\{{packageScopedName}}/${frontMatter.version}.${frontMatter.npm_subversion}/.content/
+├── README.md
+├── bin
+TODO
+`} </CodeBlock>
+
+</TabItem>
+
+{%- endcase %}
+{%- endfor %}
+
+</Tabs>
+
 <DeprecationNotices/>
 
 <DownloadAnalytics version={frontMatter.version}/>

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/bash-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/bash-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/bash-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/bash-xpack.git; npm run generate-top-commons)
+npm run generate-top-commons -C ~/Work/xpack-dev-tools/bash-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/bash-xpack.git/website
 ```
+
+### Commit the website changes
+
+- Stage the `website` folder and top `README.md`
+- **Commit** with the message _**re-generate website commons**_