JAL-3503 2.11.2.0 release notes and docs
[jalview.git] / help / help / html / whatsNew.html
index 3538ff4..5ecf293 100755 (executable)
 </head>
 <body>
   <p>
-    <strong>Jalview 2.11 - major and minor new features</strong>
+    <strong>Welcome to Jalview Version $$Version-Rel$$ !!</strong>
+    <br />Please take a
+    look at the <a href="releases.html#Jalview.$$Version-Rel$$">release
+      notes</a> for this build. Read on for the highlights.
   </p>
-  <p>Jalview 2.11 introduces support for loading VCF files, and new
-    filters and shading models for sequence features. Under the hood,
-    we've addressed many bugs, and also made some important changes in
-    the way the Jalview desktop is installed and launched.</p>
-  <ul>
-    <li><em>VCF Support</em>. Proteins and genomic contigs with
-      chromosomal location annotation (such as protein coding genes
-      retrieved from Ensembl) can be annotated with variants imported
-      from a local VCF file.</li>
-    <li><em>The Jalview Launcher and Update System</em><br />
-      Jalview's new installation model means you'll only need to
-      download and install Jalview once. After installation, Jalview
-      will automatically keep itself up to date. The launcher also sets
-      Jalview's memory automatically, so you'll never again have to
-      manually configure Java's memory settings.<br />We are grateful to
-      Install4J who provided us with a free license for their
-      installation system, and Jalview's over the air update system is
-      via Getdown.</li>
-  </ul>
   <p>
-    The full list of bugs fixed in this release can be found in the <a
-      href="releases.html#Jalview.2.11">2.11 Release Notes</a>.
+    <strong>Highlights in 2.11.2</strong>
   </p>
   <p>
-    <strong>Jalview and Java 11, 13, and onwards</strong>
-  </p>
-  <p>Java 11 provides improved performance and better OS
-    integration, so we now recommend users select our Java 11 Jalview
-    distribution rather than the legacy Java 8 build.</p>
-  <em>Known Issues - update for 211 </em>
+    <strong>New features for working with 3D Structure</strong><br />
+    Jalview 2.11.2 features a number of new capabilities:
+  
   <ul>
-    <li>OSX: The 'Open File' dialog for Jalview's Groovy Console
-      appears with the title 'Save As', and attempting to select a file
-      to load yields a FileNotFound exception.</br>The workaround is to first
-      clear the 'Untitled' filename before selecting the file you wish
-      to load.
-    </li>
-    <li>OSX: Links don't open when clicked on or via the Sequence
-      or Alignment window popup menu.</li>
-    <li>OSX (Webstart): Jalview only displays old news feed items</li>
+    <li><strong>Linked viewing with <em>ChimeraX</em> and
+        <em>PyMol</em></strong><br />Simply configure your prefered viewer for 3D
+      molecular data in <a href="features/preferences.html#structure">Jalview's
+        structure preferences</a>, make sure that Jalview can locate the
+      viewer's installation, and open a new view via the 3D Structure
+      Chooser!</li>
+    <li><strong>View predicted protein structures via
+        3D-Beacons</strong><br /> Jalview 2.11.2's <a
+      href="features/structurechooser.html">Structure Chooser
+        includes a client for the 3D-Beacons Network</a>, a new service that
+      allows predicted and observed 3D models for proteins in Uniprot
+      from a range of resources, including AlphaFold DB, SWISS-MODEL and
+      a growing number of other resources.</li>
+      <li><strong>Easier configuration of <a href="features/preferences.html#startup">Jalview's memory allocation</a></strong>
+    <p>
+      <strong>Retrieval of 3D models via 3D-Beacons</strong> <br>The
+      3D-Beacons network (<a
+        href="https://www.ebi.ac.uk/pdbe/pdbe-kb/3dbeacons/">www.ebi.ac.uk/pdbe/pdbe-kb/3dbeacons/</a>)
+      provides a central point for the retrieval of predicted and
+      observed 3D structures for sequences in Uniprot, including
+      homology models from Swiss-model and deep learning based
+      predictions from the EBI's Alphafold database (Orengo et al. 2020,
+      <a href="https://doi.org/10.12688/f1000research.20559.1">doi:10.12688/f1000research.20559.1</a>).<br>
+      See the <a href="features/structurechooser.html">Structure
+        Chooser's documentation</a>.
+    </p>
+    <p>
+      <strong>Support for viewing structures with ChimeraX and
+        Pymol</strong><br> Jalview's 3D structure viewer system has been
+      re-architected to allow easier integration of external structure
+      viewers, and takes advantage of the strucViz2 Chimera
+      communications library developed by Scooter Morris (<a
+        href="https://doi.org/10.1093/bioinformatics/btm329">doi:10.1093/bioinformatics/btm329</a>).
+        The Structures Preferences tab provides new options
+      allowing ChimeraX and Pymol to be used for visualising external 3D
+      structures. Jalview 2.11.2 has been tested with Pymol 2.5.0
+      (community) and 2.5.2 (incentive). For ChimeraX, we recommend
+      using v1.3 or later. 
+    </p>
+    <p>
+      For the full release notes, see <a
+        href="releases.html#Jalview.2.11.2.0">the Jalview 2.11.2.0
+        release notes</a>.
+    </p>
+    <p>
+      <strong>Known Issues</strong>
+    </p>
+    <p></p>
   </ul>
 </body>
 </html>