fix formatting issues by changing the layout

docs/install-josm/linux.md

@@ -36,54 +36,54 @@ Alternatively you can use your software center if it's set up for Flatpak.
 
 ### Ubuntu, Debian and derivatives
 
-1. Register the official JOSM repository
+Register the official JOSM repository
 
 ```bash
 echo "deb https://josm.openstreetmap.de/apt alldist universe" > /etc/apt/sources.list.d/josm.list
 ```
 
-2. Register the public key of that repository
-   using `wget`
+and then its public key<br/>
+using `wget`
 
 ```bash
 wget -q https://josm.openstreetmap.de/josm-apt.key -O- > /etc/apt/trusted.gpg.d/josm.gpg
 ```
 
-   or using `curl`
+or using `curl`
 
 ```bash
 curl https://josm.openstreetmap.de/josm-apt.key > /etc/apt/trusted.gpg.d/josm.gpg
 ```
 
-3. Refresh the sources
+Before attempting to install refresh the sources
 
 ```bash
 sudo apt update
 ```
 
-4. Install JOSM
+to be able to finally install JOSM
 
 ```bash
 sudo apt install josm
 ```
 
 ### OpenSUSE
 
-1. Grab the version
+Grab the version
 
 ```bash
 version=`cat /etc/os-release | grep "VERSION_ID"`
 version=${version/VERSION_ID=/}
 version=${version//\"/}
 ```
 
-2. Add Geo repository
+and add the 'Geo' depot
 
 ```bash
 zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_${version} Application:Geo
 ```
 
-3. Install JOSM
+in order to be able to install JOSM using
 
 ```bash
 zypper install josm josm-fonts
@@ -93,27 +93,27 @@ zypper install josm josm-fonts
 
 **Use this only when the steps in "Ubuntu, Debian and derivatives" don't work for you.**
 
-1. Get codename of your debian installation
+Get codename of your debian installation first
 
 ```bash
 codename=`cat /etc/os-release | grep "VERSION_CODENAME"`
 codename=${codename/VERSION_CODENAME=/}
 codename=${codename//\"/}
 ```
 
-2. Add backports repository
+to be able to add the right backports repository
 
 ```bash
 echo "deb http://deb.debian.org/debian ${codename}-backports main" > /etc/apt/sources.list.d/backports.list
 ```
 
-3. Update sources
+Before attempting to install refresh the sources
 
 ```bash
 apt update
 ```
 
-4. Install JOSM from backports
+and now finally install JOSM from backports
 
 ```bash
 apt install josm/${codename}-backports

docs/install-josm/mac.md

@@ -5,7 +5,12 @@ We will cover here how to install JOSM on Mac using various methods.
 ## 1. Method: Install JOSM via Homebrew
 
 1. Open a terminal
-2. Execute `brew install --cask josm` to install
+2. Execute
+```bash
+brew install --cask josm
+```
+
+to install
 
 ## 2 Method: Install JOSM using a package