updated / synced installation instructions

src/content/docs/manual/intro.mdx

@@ -112,15 +112,70 @@ SocNetV is Free Software licensed under the [GNU General Public License 3 (GPL3)
 
 ## Installation Instructions
 
-The latest version of SocNetV can be downloaded from the project's [Downloads](http://socnetv.org/downloads) page.
+SocNetV is multi-platform, which means that it can be installed and run in every Operating System supported by the Qt toolkit.
 
-SocNetV supports Windows, macOS, and Linux distributions.
+In fact, the project offers binaries and installers for the three major Operating Systems:
 
-1. **Windows**: Download the latest installer, double-click to install, and follow the prompts.
-2. **macOS**: Download the `.dmg` file, double-click, and drag the app to your Applications folder.
-3. **Linux**: Download the Linux AppImage, make it executable, and run it. Alternatively, use the provided packages or repositories for your distribution.
+* Windows, 
+* macOS 
+* Linux
 
-Find detailed installation instructions in the respective [OS-specific sections](../downloads).
+The latest release of SocNetV can be downloaded from the project's [Downloads](/downloads) page.
+
+If there is no binary package for your OS, please download and compile the source code,
+as explained below.
+
+### Install in Windows
+
+To install SocNetV in Windows, download the latest SocNetV Windows installer from
+the [Downloads](/downloads) page, and double-click on the executable to start the installation.
+
+:::note
+You might see a Windows pop up about unknown software origin/publisher. Please ignore it and proceed, as we do not sign our released packages with any code signing certificates (which are not free by the way). 
+:::
+
+Click Next and Accept the License (GPL) to install the program.
+
+The program will be installed in the usual Windows Program Files directory and a new
+Start Menu shortcut will be created.
+
+Afterwards you can run the application from your Start menu.
+
+### Install in macOS
+
+To install SocNetV in macOS, download the latest SocNetV macOS package from
+the [Downloads](https://socnetv.org/downloads) page. Then right-click on it and select Open.
+
+If the package is an installer, the installation will start immediately and the application 
+will be installed automatically in your Applications.
+
+Otherwise, if the package is just an macOS image disk (a file with a `.dmg` extension), then double-click on it to open it. 
+You will see a new window with the SocNetV executable icon inside. Right-click on it and select Open to run the application. 
+
+:::note
+Note: The first time you will run SocNetV, macOS may tell you that it cannot verify the software developer/publisher. That's because we do not sign our released packages with any code signing certificates (which are not free by the way). 
+Please press Cancel, not Move to Bin! Then, right-click again on SocNetV app and select Open to run the application normally.  
+:::
+
+After that, in order to permanently install SocNetV in your macOS, you can simply drag the SocNetV executable icon into your Applications.
+
+Alternatively, there is a SocNetV port in MacPorts (thanks to Szabolcs Horvát!). It can be installed with the command:
+
+```bash
+port install socnetv
+```
+
+### Install in Linux
+
+To run the latest and greatest version of SocNetV in Linux, download the latest Linux AppImage from
+the [Downloads](/downloads) page.
+
+Then, make the .appimage file executable and double-click on it to run SocNetV. That's it. :)
+
+:::note
+Please note that SocNetV is also available in the [repositories of most Linux distributions](https://repology.org/project/socnetv/versions). 
+However, that is not always the most recent version. We urge you to use the AppImage of the latest version available from our website instead.
+:::
 
 ---