website: add developer/install/maintainer/user pages

Author: ilg-ul

build-assets/package.json

@@ -7,7 +7,7 @@
   "xpack": {
     "minimumXpmRequired": "0.16.3",
     "devDependencies": {
-      "@xpack-dev-tools/xbb-helper": "^3.0.16"
+      "@xpack-dev-tools/xbb-helper": "^3.0.17"
     },
     "properties": {
       "appName": "Binary Development Tools",
@@ -16,7 +16,11 @@
         "isOrganizationWeb": "true",
         "docusaurusTagline": "Cross-platform binary tools for software development, aimed at reproducible builds",
         "docusaurusBaseUrl": "/",
-        "gitHubProjectName": "xpack-dev-tools.github.io"
+        "gitHubProjectName": "xpack-dev-tools.github.io",
+        "hasCustomDeveloper": "true",
+        "hasCustomInstall": "true",
+        "hasCustomMaintainer": "true",
+        "hasCustomUser": "true"
       },
       "xpm-version": "0.18.0",
       "xpm-install-loglevel": "info",

website/docs/developer/_custom-developer.mdx

@@ -0,0 +1,15 @@
+
+{/* ------------------------------------------------------------------------ */}
+
+Each project has separate pages designed for developers who plan to
+contribute new features or fix bugs, and includes documentation on
+how to build and test the package.
+
+Please follow the **Contributor's Guide** menu for each project.
+
+## Prerequisites
+
+The build scripts run on GNU/Linux and macOS.
+
+The detailed steps to install the prerequisites are provided in the
+[Build Prerequisites](./install/prerequisites/) page.

website/docs/developer/index.mdx

@@ -0,0 +1,28 @@
+---
+
+# DO NOT EDIT!
+# Automatically generated from xbb-helper/templates/docusaurus/common.
+
+title: Contributor's Guide
+description: Guidance for developers aiming to contribute new features or bug fixes, detailing how to build the binaries, including prerequisites, repositories utilised, and scripts.
+keywords:
+  - xpack
+  - xpack-dev-tools.github.io
+  - prerequisites
+  - build
+
+date: 2024-07-21 20:33:00 +0300
+
+---
+
+
+
+import CustomDeveloper from './_custom-developer.mdx'
+
+{/* ------------------------------------------------------------------------ */}
+
+# Contributor's Guides
+
+<CustomDeveloper />
+
+

website/docs/developer/install/prerequisites/_npm-xpm-details.mdx

@@ -0,0 +1,34 @@
+
+
+### node/npm
+
+`npm` is included with Node.js and is required to install `xpm`.
+
+For full details on installing Node.js, please refer to the
+[xPack prerequisites](http://xpack.github.io/install/) page.
+
+:::caution
+
+Ensure you **do not** install npm with administrative rights,
+such as via a system package manager. Instead, use `nvm` as
+instructed to avoid permission-related issues.
+
+:::
+
+### xpm
+
+[`xpm`](https://xpack.github.io/xpm/) is a portable
+[Node.js](https://nodejs.org/) command line application.
+
+If you followed the _Quick instructions_, it is already installed.
+
+Otherwise, to install it, follow the steps in the
+[xpm install](http://xpack.github.io/xpm/install/) page.
+
+If you are confident in your knowledge and prefer a shortcut,
+issue the following command:"
+
+
+```sh
+npm install --global xpm@latest
+```

website/docs/developer/install/prerequisites/_npm-xpm-tldr.mdx

@@ -0,0 +1,38 @@
+
+
+## npm/xpm
+
+### Quick instructions
+
+If you are confident in your knowledge and prefer a shortcut, copy and
+paste the following
+[script](https://github.com/xpack/assets/blob/master/scripts/install-nvm-node-npm-xpm.sh)
+into a terminal (otherwise, perform the steps one by one).
+
+:::caution
+
+For security reasons, conscientious users should first check
+the content of the file before executing it.
+
+:::
+
+```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"
+
+bash "${HOME}/Downloads/install-nvm-node-npm-xpm.sh"
+
+exit
+```
+
+This script will install `nvm` (the Node Version Manager), `node`,
+`npm` and `xpm`.
+
+:::info
+
+To activate `nvm` automatically,
+the script adds several lines
+to the shell initialisation script.
+
+:::