website: re-generate commons

Author: ilg-ul

website/docs/_common/_symbolic-links-require-ntfs.mdx

@@ -0,0 +1,15 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from docusaurus-template-liquid/templates/docusaurus. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+By design, xpm utilises symbolic links to folders (junction points on
+NTFS) to facilitate the sharing of common packages across projects. Any
+attempt to install packages on a drive that does not support symbolic
+links will result in an error:
+
+```
+error: volume X: does not support links, it might not be NTFS, or it might be a remote resource
+```
+
+Utilise a recent version of Windows and format the drive as NTFS.

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

@@ -0,0 +1,13 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from docusaurus-template-liquid/templates/docusaurus. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+### Update the top commons
+
+Execute the top **generate-top-commons** npm script to update the
+`build-assets/package.json` and the GitHub workflow files.
+
+```sh
+npm run generate-top-commons -C ~/Work/xpack-dev-tools/xpack-build-box.git
+```

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

@@ -0,0 +1,13 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from docusaurus-template-liquid/templates/docusaurus. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+### Update the website commons
+
+Execute the **generate-website-commons** npm script from `website/package.json`
+within the project folder.
+
+```sh
+npm run generate-website-commons -C ~/Work/xpack-dev-tools/xpack-build-box.git/website
+```

website/docs/getting-started/_common/_credits-mac-stadium.mdx

@@ -9,7 +9,7 @@ import Link from '@docusaurus/Link';
 
 ## Credits
 
-Special thanks to **MacStadium**, for providing the Apple Silicon
+Special thanks to **MacStadium** for providing the Apple Silicon
 development infrastructure as part of their generous
 [Free and Open Source Software](https://www.macstadium.com/company/opensource)
-program.
+programme.

website/docs/getting-started/_common/_enjoyed-using.mdx

@@ -3,12 +3,17 @@
 
 {/* ------------------------------------------------------------------------ */}
 
-## Enjoyed Using This Project? Let Us Know!
+## Enjoyed Using This Project? Please Let Us Know!
 
-If you enjoyed using this project, please let us know! Here are some ways you can show your support:
+If you have found this project valuable, we would appreciate hearing from you!
+Here are some ways you can demonstrate your support:
 
-- **Donate**: Your contributions, whether small or generous, help us keep the
-xPack 
-projects thriving. [![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif)](https://www.paypal.com/donate/?hosted_button_id=5MFRG9ZRBETQ8)
-- **Star** the project on [GitHub](https://github.com/xpack-dev-tools/xpack-build-box/): It helps others discover our work.
-- **Follow** us on [X/Twitter](https://twitter.com/xpack_project/): Stay updated with our latest releases and news.
+- **Donate**: Every contribution, regardless of size, helps sustain the
+xPack project.
+Your generosity maintains the development and ensures continued progress.
+- **Star** the project on [GitHub](https://github.com/xpack-dev-tools/xpack-build-box/):
+Assist others in discovering our work by giving it a star — it truly makes a difference!
+- **Follow Us** on [X/Twitter](https://twitter.com/xpack_project/): Stay informed about our latest updates, releases,
+and news by following our account.
+
+Your support is greatly appreciated and motivates us to continue improving!

website/docs/getting-started/_common/_license.mdx

@@ -3,9 +3,9 @@
 
 {/* ------------------------------------------------------------------------ */}
 
-## License
+## Licence
 
-Unless otherwise stated, the original content is released under the terms of the
-[MIT License](https://opensource.org/license/mit/),
-with all rights reserved by
-[Liviu Ionescu](https://github.com/ilg-ul).
+Unless explicitly stated otherwise, the original content is
+distributed under the terms of the
+[MIT Licence](https://opensource.org/license/mit), with all
+rights reserved by [Liviu Ionescu](https://github.com/ilg-ul).

website/docs/getting-started/_common/_user-developer-maintainer.mdx

@@ -3,13 +3,13 @@
 
 {/* ------------------------------------------------------------------------ */}
 
-:::info Separate User/Maintainer pages
+:::info Dedicated Pages for Different Audiences
 
-To address the specific needs of different
-audiences, this site features separate
+To accommodate the diverse requirements of its audience, this site provides
+distinct pages:
 **[User's Guide](/docs/user/)** and
-**[Maintainer's Guide](/docs/maintainer/)**
-pages. This way, each group can easily find the information and resources
-most relevant to them.
+**[Maintainer's Guide](/docs/maintainer/)**.
+Each guide is tailored to ensure users can efficiently access the
+information and resources most relevant to their specific roles or requirements.
 
 :::

website/docs/install/_common/_prerequisites.mdx

@@ -0,0 +1,52 @@
+{/* DO NOT EDIT! */}
+{/* Automatically generated from docusaurus-template-liquid/templates/docusaurus. */}
+
+{/* ------------------------------------------------------------------------ */}
+
+### Prerequisites
+
+The only requirement for an automated installation is a recent
+[xpm](https://xpack.github.io/xpm/), which is a portable
+[Node.js](https://nodejs.org) command line application
+that complements [npm](https://docs.npmjs.com)
+with several additional features specific to
+**C/C++ projects**.
+
+To install **xpm**,
+follow the instructions on the
+[xpm install](https://xpack.github.io/xpm/install/) page.
+
+If already installed, it is always advisable to update it to the
+latest version with:
+
+```sh
+npm install --location=global xpm@latest
+```
+
+:::tip
+
+Although not mandated by **xpm**, it is also advisable to upgrade
+**npm** to the latest version, and
+**node** to a reasonably recent version (currently **npm** requires
+a **node** >=18.17.0).
+
+:::
+
+<details>
+<summary>Local installations</summary>
+
+One of the xPack design goals is to allow each project to
+select the exact versions of the libraries it requires.
+
+Similarly to **npm** being able to install specific versions of the
+JavaScript tools into each project,
+**xpm** was also designed to be able to install specific versions of the
+required libraries locally into each project.
+
+Therefore, similarly to the way **npm** installs the JavaScript packages into
+`node_modules`, **xpm** installs the libraries into
+`xpacks`. Here there will be separate folders with the installed
+packages, for example
+<code>xpacks/xpack-build-box</code>.
+
+</details>

website/docs/install/index.mdx

@@ -3,7 +3,7 @@
 # DO NOT EDIT!
 # Automatically generated from docusaurus-template-liquid/templates/docusaurus.
 
-title: Install Guide
+title: Installation Guide
 description: Explain the prerequisites, how to perform an automated installation, how to uninstall.
 keywords:
   - xpack

website/docs/maintainer/_common/_first-development-run-gcc.mdx

@@ -0,0 +1,17 @@
+
+import versionMajor from '@site/src/libs/versionMajor';
+
+{/* ------------------------------------------------------------------------ */}
+
+The strategy with the development builds is to run them in descending order
+({versionMajor()}.2, {versionMajor() - 1}.3, {versionMajor() - 2}.4, {versionMajor() - 3}.5).
+
+For this update the top `package.json` and `build-assets/scripts/VERSION` files
+and run the build scripts.
+
+After each build, save the folder hierarchies and executables, to be used
+in the blog posts.
+
+Then perform the steps to make the production builds in ascending order
+({versionMajor() - 3}.5, {versionMajor() - 2}.4, {versionMajor() - 1}.3, {versionMajor()}.2),
+with full tests and website updates.