website text fixes

Author: ilg-ul

website/docs/developer/js-style-guide/index.mdx

@@ -1,7 +1,7 @@
 ---
 
 title: JavaScript/TypeScript Style Guide
-description: For consistency, use automated validation tools (prettier & ESlint).
+description: For consistency, use automated validation tools (prettier & ESLint).
 keywords:
   - xpack
   - javascript
@@ -33,7 +33,7 @@ To ensure consistency in the xPack JavaScript/TypeScript source files, the
 primary requirements are:
 
 - use [prettier](https://prettier.io) for automated re-formatting
-- use [ESlint](https://eslint.org) as a validation tool, which also
+- use [ESLint](https://eslint.org) as a validation tool, which also
 has a TypeScript variant
 ([typescript-eslint](https://typescript-eslint.io/packages/typescript-eslint/))
 

website/docs/getting-started/_project/_content.mdx

@@ -59,7 +59,7 @@ and **multi-configuration builds**, in a **reproducible** way.
 
 :::
 
-Based on a straightforward multi-version dependencies manager
+Based on a straightforward multi-version dependency manager
 built on top of **npm**, the xPack Project aims to provide a
 suite of cross-platform tools. These tools are designed to manage,
 **configure**, **build** and **test** complex, modular,
@@ -99,7 +99,7 @@ executed repeatedly with identical results across different
 platforms and over time enhances the reliability and stability
 of the development process.
 3. **Modularity and Flexibility**: The focus on complex, modular
-projects allows for better organization and scalability. Developers
+projects allows for better organisation and scalability. Developers
 can work on individual components without affecting the entire
 system, facilitating easier maintenance and updates.
 4. **Cross-Platform Compatibility**: Tools designed to work across
@@ -108,7 +108,7 @@ project can be adapted to different environments, making it
 versatile and adaptable to various development needs.
 5. **Specialization in C/C++ and Bare-Metal Embedded Projects**:
 By targeting specific areas like C/C++ and bare-metal embedded
-projects, the tools can offer specialized features and optimizations
+projects, the tools can offer specialised features and optimisations
 that cater to the unique requirements of these domains.
 6. **Improved Code Sharing and Reuse**: The use of a multi-version
 dependencies manager built on top of npm promotes better code sharing

website/docs/getting-started/prerequisites/_use-nvm.mdx

@@ -1,4 +1,5 @@
 import Heading from '@theme/Heading';
+import CodeBlock from '@theme/CodeBlock';
 
 {/* ------------------------------------------------------------------------ */}
 
@@ -36,20 +37,37 @@ should review the content of the file before executing it.
 
 If you trust the script, you can use the following shortcut:
 
-```sh
-curl https://raw.githubusercontent.com/xpack/assets/master/scripts/install-nvm-node-npm-xpm.sh | bash
+{props.os === 'macos' ? (
+<CodeBlock language="sh">
+{`curl --fail --silent --show-error --location https://raw.githubusercontent.com/xpack/assets/master/scripts/install-nvm-node-npm-xpm.sh | \${SHELL}
 
-export NVM_DIR="${HOME}/.nvm"
-source "${NVM_DIR}/nvm.sh"
-```
+export NVM_DIR="\${HOME}/.nvm"
+source "\${NVM_DIR}/nvm.sh"`}
+</CodeBlock>
+) : (
+<CodeBlock language="sh">
+{`wget --quiet --output-document=- https://raw.githubusercontent.com/xpack/assets/master/scripts/install-nvm-node-npm-xpm.sh | \${SHELL}
+
+export NVM_DIR="\${HOME}/.nvm"
+source "\${NVM_DIR}/nvm.sh"`}
+</CodeBlock>
+)}
 
 Otherwise download and check the script:
 
-```sh
-mkdir -pv "${HOME}/Downloads/"
-curl --output "${HOME}/Downloads/install-nvm-node-npm-xpm.sh" https://raw.githubusercontent.com/xpack/assets/master/scripts/install-nvm-node-npm-xpm.sh
-cat "${HOME}/Downloads/install-nvm-node-npm-xpm.sh"
-```
+{props.os === 'macos' ? (
+<CodeBlock language="sh">
+{`mkdir -pv "\${HOME}/Downloads/"
+curl --output "\${HOME}/Downloads/install-nvm-node-npm-xpm.sh" https://raw.githubusercontent.com/xpack/assets/master/scripts/install-nvm-node-npm-xpm.sh
+cat "\${HOME}/Downloads/install-nvm-node-npm-xpm.sh"`}
+</CodeBlock>
+) : (
+<CodeBlock language="sh">
+{`mkdir -pv "\${HOME}/Downloads/"
+wget --quiet --output-document="\${HOME}/Downloads/install-nvm-node-npm-xpm.sh" https://raw.githubusercontent.com/xpack/assets/master/scripts/install-nvm-node-npm-xpm.sh
+cat "\${HOME}/Downloads/install-nvm-node-npm-xpm.sh"`}
+</CodeBlock>
+)}
 
 When confident, run it:
 
@@ -66,7 +84,8 @@ This script will install `nvm` (the Node Version Manager), `node`,
 
 To automatically activate `nvm`, the script adds several lines
 to the shell initialization script. Therefore, it is necessary
-to restart the shell to apply these changes.
+to restart the shell to apply these changes or to manually
+export `NVM_DIR` and source the script.
 
 :::
 

website/docs/getting-started/prerequisites/index.mdx

@@ -39,7 +39,7 @@ import VersionManager from './_version-manager.mdx';
 
 ## Overview
 
-All xPack core tools are [Node.js](https://nodejs.org) CLI application
+All xPack core tools are [Node.js](https://nodejs.org) CLI applications
 available from the
 [npmjs.com](https://www.npmjs.com) public repository. They can be installed
 via `npm`, which runs on top of **Node.js**.
@@ -60,7 +60,7 @@ If this is your first time using **npm**, you'll need to install the
 [Node.js](https://nodejs.org) ECMAScript (JavaScript) runtime.
 The installation process is
 straightforward and does not clutter system locations.
-There are two versions of Node.js: **LTS** (**Long Term Service**) and
+There are two versions of Node.js: **LTS** (**Long Term Support**) and
 **Current**. Generally, it is safer to use the **LTS** version,
 especially on Windows.
 
@@ -204,7 +204,7 @@ While not mandatory for using the xPack tools alone, it is recommended
 to install the [Git for Windows](https://git-scm.com/download/win) package too.
 
 This also installs a `bash` shell.
-The xPack Core Tools can run either in either the Windows shells or in the Git `bash` shell.
+The xPack Core Tools can run in either the Windows shells or in the Git `bash` shell.
 
 <Heading as="h2">Visual C++ Redistributable Files</Heading>
 
@@ -276,7 +276,7 @@ For further information, please refer to the Microsoft documentation, such as th
 For macOS, it is
 **strongly recommended** to **use a version manager** (see below).
 
-<UseNvm />
+<UseNvm os="macos"/>
 
 <Heading as="h2">Command Line Tools</Heading>
 
@@ -400,12 +400,12 @@ default -> 20 (-> v20.18.0)
 For GNU/Linux, it is
 **strongly recommended** to **use a version manager** (see below).
 
-<UseNvm />
+<UseNvm os="linux"/>
 
 :::info
 
 Arm platforms, like the Raspberry Pi,
-are supported, currently in both 32/64-bit variants.
+are supported, currently only in 64-bit mode.
 
 :::
 

website/docs/project/about/_project/_content.mdx

@@ -14,7 +14,7 @@ various individual projects, including tools, npm modules, and
 platform-specific executables. All these projects are hosted on
 GitHub under two groups (or
 _organizations_ in GitHub parlance): [xpack](https://github.com/xpack/) and
-[xpack-dev-tools](ttps://github.com/xpack-dev-tools/).
+[xpack-dev-tools](https://github.com/xpack-dev-tools/).
 
 <TheProjectHistory />
 

website/docs/project/about/_project/_website.mdx

@@ -9,7 +9,7 @@ The **xPack Project** web site was created in **October 2017**, using a home
 grown GitHub-like theme; however, for a while there was not much content.
 
 In **June 2019** it was reworked to use a
-more elaborated theme,
+more elaborate theme,
 [Jekyll Doc Theme 6.0](https://idratherbewriting.com/documentation-theme-jekyll/)
 by [Tom Johnson](https://github.com/tomjoht).