X-Git-Url: http://source.jalview.org/gitweb/?p=jalview.git;a=blobdiff_plain;f=README;h=5735c8e5acab9d694c3ab25aa3ab2827dffa1b47;hp=b3744791abda2d67d7f7954185182a91d5e0459b;hb=c9800715ec36a57a6e6afb13a57b927e4061242e;hpb=6377aab20b69421675cf56d539f5ba861f81fd7f

diff --git a/README b/README
index b374479..5735c8e 100644
--- a/README
+++ b/README
@@ -1,5 +1,34 @@
-Please see doc/building.md for up to date build and running instructions for the Java desktop application.
+Jalview README
+==============
 
-JalviewJS.
-See  README_GRADLE_JALVIEWJS-2019-10-22.md  for build instructions for JalviewJS.
-This is a little sparse but enough to do the transpilation.
+Welcome !  
+
+Jalview is free (GPLv3 licensed) software for creation, interactive
+visualisation and analysis of alignments of biological sequences. It
+was developed by Michele Clamp in 1996, and now maintained by the
+Jalview Development team in the Barton group at the University of
+Dundee.
+
+If you'd like to help out please check out the website
+(www.jalview.org) and get in touch. See CITATION for the canonical
+reference if you need to cite Jalview.
+
+To build the Jalview Desktop application and JalviewJS, the JavaScript
+transpiled version (with the help of java2script, courtesy of Bob
+Hanson), you will need a Java 11 JDK and a recent version of
+Gradle. For development we recommend Eclipse - you should be able to
+import Jalview as a Gradle project with the Buildship plugin.
+
+Most likely you'll want to take a look at doc/building.md to find out
+exactly what is needed. If you already have Java 11 and Gradle, then
+the tldr:
+
+gradle test # run functional test suite
+
+gradle shadowJar # build a single executable Jar under build/libs/
+
+gradle jalviewjs # builds JalviewJS under build/jalviewjs  
+
+If you want to build JalviewJS then you will also need to download
+Eclipse for your platform, since transpilation requires an Eclipse
+plugin.