diff --git a/hugo/content/installation/install/linux.md b/hugo/content/installation/install/linux.md
index 339b8dd0303c9c290512f0c0f5f330d938efbeb5..2d13858067fd3eb6f23bde4f5347986d447a586b 100644
--- a/hugo/content/installation/install/linux.md
+++ b/hugo/content/installation/install/linux.md
@@ -10,7 +10,9 @@ weight = 30
 As a prerequisite, Python must be installed.
 Check the version with `python3 --version`.
 Which versions are compatible with BornAgain
-can be inferred from the available installer at {{% url-releases %}}/linux_x64.
+can be inferred from the available installers at {{% url-releases %}}/linux_x64.
+
+In the following, we assume that `python` is an alias for `python3`.
 
 #### Install BornAgain as Python-only package
 
diff --git a/hugo/content/installation/install/macos.md b/hugo/content/installation/install/macos.md
index a991e2ba850a3e369402e7ded496095dbe8e332d..4cbb1f57bc6383fde4bd55d4ac6b9fb38e9a0670 100644
--- a/hugo/content/installation/install/macos.md
+++ b/hugo/content/installation/install/macos.md
@@ -5,72 +5,41 @@ weight = 70
 
 ## Install on MacOS
 
-BornAgain GUI application for macOS is provided as 64-bit `.dmg` installer.
+#### Prequisite: Python
 
-BornAgain Python package is available in PyPI repository and can be installed with `pip`. This package is required for running scripts or importing them into the GUI application.
+As a prerequisite, Python must be installed.
 
-To install and run BornAgain for the first time proceed with the following steps:
+Note that pre-installed Python on MacOS may be outdated.
+Check the installed version with `python3 --version`.
+Which versions are compatible with BornAgain
+can be inferred from the available installers at
+  * {{% url-releases %}}/mac_arm or
+  * {{% url-releases %}}/mac_x64.
 
-- [Install Python](#install-python)
-- [Install BornAgain Python package](#install-bornagain-python-package)
-- [Install BornAgain GUI application](#install-bornagain-gui-application)
+The official Python installers can be downloaded from https://www.python.org/downloads.
 
-
-### Install Python
-
-{{< alert theme="info" >}}
-If Python is already installed and set up, this block can be skipped.
-{{< /alert >}}
-
-{{< alert theme="warning" >}}
-While Python comes pre-installed on macOS, it is always quite outdated and not recommended to use together with BornAgain libraries.
-{{< /alert >}}
-
-The installer for appropriate version of Python can be downloaded from https://www.python.org/downloads.
-
-Choose Python version according to the compatibility table:
-
-BornAgain version | Supported Python versions
-------------------|---------------------------
-20.0              | 3.8 to 3.10
-
-
-Run the installer and follow the steps.
-
-Ensure that `pip` package manager is checked for installation. Command
-```
-$ python3 -m ensurepip
-```
-will install `pip` if it is missing.
-
-##### Alternative way
-
-For Homebrew users:
+Or use Homebrew:
 ```
 $ brew install python3
 ```
 
-### Install BornAgain Python package
+In the following, we assume that `python` is an alias for `python3`.
 
-{{< alert theme="info" >}}
-For using BornAgain as GUI application only, this block can be skipped.
-{{< /alert >}}
+#### Install BornAgain as Python-only package
 
-BornAgain Python package in available in the public repository and can be installed with `pip`:
+If the BornAgain GUI is not required as only Python scripting mode is to be used,
+then BornAgain can be installed as a Python package from the `pip` repository:
 ```
-$ python3 -m pip install bornagain
+$ python -m pip install bornagain
 ```
 
-### Install BornAgain GUI application
-
-{{< alert theme="info" >}}
-For using BornAgain in scripts only, this block can be skipped.
-{{< /alert >}}
+#### Install BornAgain GUI application
 
-The BornAgain installer can be downloaded from {{% url-releases %}}.
-Its type must match the processor architecture, e.g.
-`{{% recommended-macinstaller-amd64 %}}` or
-`{{% recommended-macinstaller-arm %}}`.
+A Linux installer for BornAgain (Python and GUI)
+can be downloaded from
+  * {{% url-releases %}}/mac_arm or
+  * {{% url-releases %}}/mac_x64.
+Choose the installer that fits your version of Python.
 
 After downloading the installer, double click `.dmg` file to mount it, accept the license agreement and then drag the BornAgain icon onto the Applications shortcut icon.