JAL-3248 extra tl;dr

diff --git a/doc/building.md b/doc/building.md
index ae76ced..0453c23 100644 (file)
--- a/doc/building.md
+++ b/doc/building.md
@@ -5,12 +5,17 @@
 ```
 # download
 git clone http://source.jalview.org/git/jalview.git
-#compile
+# compile
 cd jalview
-gradle getdown
+gradle shadowJar
 # run
-cd getdown/files/11
-java -jar gradle-launcher.jar . jalview
+java -jar build/libs/jalview-all-11.jar
+
+# and/or create launcher
+gradle getdown
+# use launcher
+cd getdown/files
+java -jar getdown-launcher.jar . jalview
 ```
 
 
@@ -23,7 +28,7 @@ The method here is described in terms of using a command line.  You can easily d
 * git
 
 ### Java 11 JDK
-We recommend obtaining an OpenJDK JDK 11 from AdoptOpenJDK: <https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot>, either the *Installer* or `.zip`/`.tar.gz` variants whichever you prefer (if you're not sure, choose the *Installer*).
+We recommend obtaining an OpenJDK JDK 11 (since 11 is the long term support release) from AdoptOpenJDK: <https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot>, either the *Installer* or `.zip`/`.tar.gz` variants whichever you prefer (if you're not sure, choose the *Installer*).
 
 ### gradle and git
 You should be able to install the latest (or close to the latest) versions of gradle and git using your OS package manager.
@@ -55,7 +60,7 @@ run
 ```
 
 ##### for RPM-based distributions (e.g. Fedora, CentOS, RedHat)
-run (probably)
+run
 
 ```
 sudo yum install gradle git