minor corrections

docs/install-josm/linux.md

@@ -18,7 +18,7 @@ or use flatpaks' auto resolving functionality:
 flatpak install josm
 ```
 
-Alternatively you can use your software center if it's set up for Github.
+Alternatively you can use your software center if it's set up for Flatpak.
 
 **Flatpak needs to be installed on your system for this to work. We recommend all JOSM users to install using this method because this is the smartest, safiest and easiest way of installing applications on Linux. So consider installing and setting up Flatpak if you don't already have.**
 
@@ -27,12 +27,12 @@ Alternatively you can use your software center if it's set up for Github.
 1. Install using our own script we wrote with support of some linux systems which you can download [here](https://trufi-association.org/installJOSM.sh) (external link to our website).
 2. Save it somewhere on your disk e.g. *Downloads* folder.
 3. Flag is as an executable (right click on file --> *Properties* --> *Permissions* --> check *make it executable* or similiar)
-4. Execute it as the superuser (*root* user).
+4. Execute it as the superuser (*root* user) in a terminal because your attention is needed.
 4. After successfull execution you can remove that script.
 
 ## 3. Method: Using package management system (not recommended)
 
-**Open a terminal/konsole and execute all following commands as root**
+**Open a terminal/konsole and execute all following commands as root**. Our bash install script runs these commands automatically after detecting the appropriate available installation method on the system.
 
 ### Ubuntu, Debian and derivatives
 
@@ -46,13 +46,13 @@ Alternatively you can use your software center if it's set up for Github.
    using `wget`
 
    ```bash
-   wget -q https://josm.openstreetmap.de/josm-apt.key -O- | apt-key add -
+   wget -q https://josm.openstreetmap.de/josm-apt.key -O- > /etc/apt/trusted.gpg.d/josm.gpg
    ```
 
    or using `curl`
 
    ```bash
-   curl https://josm.openstreetmap.de/josm-apt.key | apt-key add
+   curl https://josm.openstreetmap.de/josm-apt.key > /etc/apt/trusted.gpg.d/josm.gpg
    ```
 
 3. Refresh the sources
@@ -83,10 +83,10 @@ Alternatively you can use your software center if it's set up for Github.
    zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_${version} Application:Geo
    ```
 
-3. Install JOSM (not tested)
+3. Install JOSM
 
    ```bash
-   zypper in josm josm-fonts
+   zypper install josm josm-fonts
    ```
 
 ### Debian
@@ -96,8 +96,8 @@ Alternatively you can use your software center if it's set up for Github.
 1. Get codename of your debian installation
 
    ```bash
-   codename=`cat /etc/os-release | grep "DISTRIB_CODENAME"`
-   codename=${codename/DISTRIB_CODENAME=/}
+   codename=`cat /etc/os-release | grep "VERSION_CODENAME"`
+   codename=${codename/VERSION_CODENAME=/}
    codename=${codename//\"/}
    ```
 

docs/install-josm/mac.md

@@ -20,9 +20,9 @@ Use this method if you **don't have** Homebrew installed, installation of Homebr
 
 Use this method if you **have** Java installed, installation of Java JRE on Mac is not a problem for you or JOSM is not your only application which depends on Java.
 
-1. Go to https://josm.openstreetmap.de
+1. Go to <https://josm.openstreetmap.de>
 2. Download [josm-tested.jar](https://videos.openstreetmap.de/kategorien/Basics/Changesets.mkv) (external link).
    ![](./website-jar-download/out.png)
 3. Save it somewhere on your disk e.g. create a *Portable Apps* folder on your desktop and put that file in there. This way you also maintain a good structure in using portable apps.
 4. Execute JOSM by double clicking on its file.
-   **If nothing happens over 10 seconds (depending on your hardware) that means probably you haven’t Java installed or the file association *.jar* not properly associated with Java.**
+   **If nothing happens over 10 seconds (depending on your hardware) that means probably you haven’t Java installed or the file association *.jar* not properly associated with it.**

docs/install-josm/windows.md

@@ -6,19 +6,20 @@ We will cover here how to install JOSM on Windows using various methods.
 
 Use this method if you **don't have** Java installed, installation of Java JRE on Windows is too complicated or JOSM will be your only application which depends on Java.
 
-1. Go to https://josm.openstreetmap.de
+1. Go to <https://josm.openstreetmap.de>
 2. Download [Windows installer](https://josm.openstreetmap.de/download/windows/josm-setup.exe) (external link).
    ![](website-exe-download/out.png)
 3. Save it somewhere e.g. in your *Downloads* folder and execute it.
+3. After successfull installation you can remove that installer.
 
 ## 2. Method: Install JOSM as `.jar`
 
 Use this method if you **have** Java installed, installation of Java JRE on Windows is not a problem for you or JOSM is not your only application which depends on Java.
 
-1. Go to https://josm.openstreetmap.de
+1. Go to <https://josm.openstreetmap.de>
 2. Download [josm-tested.jar](https://videos.openstreetmap.de/kategorien/Basics/Changesets.mkv) (external link).
    ![](./website-jar-download/out.png)
 3. Save it somewhere on your disk e.g. create a *Portable Apps* folder on your desktop and put that file in there. This way you also maintain a good structure in using portable apps.
 4. Execute JOSM by double clicking on its file.
-   **If nothing happens over 10 seconds (depending on your hardware) that means probably you haven’t Java installed or the file association *.jar* not properly associated with java.**
+   **If nothing happens over 10 seconds (depending on your hardware) that means probably you haven’t Java installed or the file association *.jar* not properly associated with it.**