a86827f92ed8795e87539b2829821c0d824b5f36
lrnassar
  Tue Mar 19 15:07:51 2019 -0700
More work on unreleased FAQgenes page ref#22696

diff --git src/hg/htdocs/FAQ/FAQgenes.html src/hg/htdocs/FAQ/FAQgenes.html
index f33ca1e..0a1fc49 100755
--- src/hg/htdocs/FAQ/FAQgenes.html
+++ src/hg/htdocs/FAQ/FAQgenes.html
@@ -4,32 +4,32 @@
 
 <!-- Relative paths to support mirror sites with non-standard GB docs install -->
 <!--#include virtual="$ROOT/inc/gbPageStart.html" -->
 
 <h1>Frequently Asked Questions: Gene tracks</h1>
 
 <h2>Topics</h2>
 
 <ul>
 <li><a href="#gene">What is a gene?</a></li>
 <li><a href="#genestrans">What is the difference between a gene and a transcript?</a></li>
 <li><a href="#mostCommon">What are the most common gene transcript tracks?</a></li>
 <li><a href="#genename">What is a gene name?</a></li>
 <li><a href="#ens">What are Ensembl and GENCODE and is there a difference?</a></li>
 <li><a href="#ensRefseq">What are the differences among GENCODE, Ensembl and RefSeq?</a></li>
-<li><a href="#hg19">For the human assembly hg19/GRCh37: What is the difference between UCSC 
-                    Genes track, the "GENCODE" track and the "Ensembl Genes" track?</a></li>
+<li><a href="#hg19">For the human assembly hg19/GRCh37: What is the difference between "UCSC 
+                    Genes" track, the "GENCODE" track and the "Ensembl Genes" track?</a></li>
 <li><a href="#hg38">For the human assembly hg38/GRCh38: What are the differences between the 
 		    "GENCODE" and "All GENCODE" tracks?</a></li>
 <li><a href="#gencode">What is the difference between GENCODE comprehensive and basic?</a></li>
 <li><a href="#ncbiRefseq">What is the difference between "NCBI RefSeq" and "UCSC RefSeq"?</a></li>
 <li><a href="#ccds">What is CCDS?</a></li>
 <li><a href="#justsingle">How can I just show a single transcript per gene?</a></li>
 <li><a href="#whatdo">This is rather complicated. Can you tell me which gene transcript track
                       I should use?</a></li>
 </ul>
 <hr>
 <p>
 <a href="index.html">Return to FAQ Table of Contents</a></p>
 
 <a name="gene"></a>
 <h2>The basics</h2>
@@ -196,32 +196,36 @@
 
 <a name="gencode"></a>
 <h6>What is the difference between "GENCODE Comprehensive" and "GENCODE Basic"?</h6>
 <p> 
 The &quot;<a target=_blank href="../cgi-bin/hgTrackUi?db=hg38&g=knownGene">GENCODE</a>&quot; track 
 offers a &quot;basic&quot; gene set, and a &quot;comprehensive&quot; gene set. The 
 &quot;basic&quot; gene set represents a subset of transcripts that GENCODE believes will be 
 useful to the majority of users. The &quot;basic&quot; gene set is defined as follows in the
 <a target=_blank href="https://www.gencodegenes.org/pages/tags.html">GENCODE FAQ</a>:</p>
 <p><i>
 &quot;Identifies a subset of representative transcripts for each gene; prioritises full-length 
 protein coding transcripts over partial or non-protein coding transcripts within the same gene, and 
 intends to highlight those transcripts that will be useful to the majority of users.&quot;</i></p>
 <p>
 By default, the track displays only the &quot;basic&quot; set. In order to display the complete 
-&quot;comprehensive&quot; set, the box can be tickets at the top of the <a target=_blank 
-href="../cgi-bin/hgTrackUi?db=hg38&g=knownGene">GENCODE track description page</a>.
+&quot;comprehensive&quot; set, the box can be ticked at the top of the <a target=_blank 
+href="../cgi-bin/hgTrackUi?db=hg38&g=knownGene">GENCODE track description page</a>.</p>
+
+<p class='text-center'>
+  <img class='text-center' src="../images/ComprehensiveSet.png" 
+alt="Turning on comprehensive gene set" width="750">
 
 <a name="ncbiRefseq"></a>
 <h6>What is the difference between "NCBI RefSeq" and "UCSC RefSeq"?</h6>
 <p>
 RefSeq gene transcripts, unlike GENCODE/Ensembl/UCSC Genes, are sequences that can differ from 
 the genome. They need to be aligned to the genome to create transcript models.
 Traditionally, UCSC has aligned RefSeq with BLAT (UCSC RefSeq sub-track) and NCBI has aligned with 
 splign. The advantages of the UCSC alignments are that
 they are updated more frequently and are available for older assemblies (like
 GRCh37/hg19), but they are less stable and they are not the official alignments.
 Therefore we recommend working with the NCBI annotations.
 When an assembly has an &quot;NCBI RefSeq&quot; track, we show it by default and hide the
 &quot;UCSC RefSeq&quot; track.
 </p>
 
@@ -261,53 +265,63 @@
 </p>
 
 <a name="ccds"></a>
 <h6>What is CCDS?</h6>
 <p>
 The <a target=_blank href="https://www.ncbi.nlm.nih.gov/projects/CCDS/CcdsBrowse.cgi">
 Consensus Coding Sequence Project</a> is a list of transcript coding sequence (CDS) genomic regions
 that are identically annotated by RefSeq and Ensembl/GENCODE.   CCDS undergoes extensive manual
 review and you can consider these a subset of either gene track, filtered for high quality.
 The CCDS identifiers  are very stable and allow you to link easily between the different databases.
 As  the name implies, it does not cover UTR regions or non-coding transcripts.
 </p>
 
 <a name="justsingle"></a>
 <h6>How can I just show a single transcript per gene?</h6>
+
 <p> 
 For the tracks &quot;<a target=_blank 
 href="../cgi-bin/hgTrackUi?db=hg19&g=knownGene">UCSC Genes</a>&quot; 
 (hg19) or &quot;<a target=_blank 
 href="../cgi-bin/hgTrackUi?db=hg38&g=knownGene">GENCODE Genes</a>&quot; 
 (hg38), click on their title and on the configuration page, uncheck the 
 box &quot;Show splice variants&quot;. Only a single transcript will be shown. The method for how this
 transcript is selected is described in the track documentation below the 
 configuration settings.</p>
 
+<p class='text-center'>
+  <img class='text-center' src="../images/SpliceVariants.png" 
+alt="Changing splice variants" width="750">
+
 <p>For the track <a target=_blank 
 href="../cgi-bin/hgTrackUi?db=hg38&g=refSeqComposite">
 NCBI RefSeq</a> (hg38), you can activate the subtrack &quot;RefSeq HGMD&quot;.
 It contains only the transcripts that are part of the Human Gene Mutation Database.
 </p>
 
 <a name="whatdo"></a>
 <h6>This is rather complicated. Can you tell me which gene transcript track I should use?</h6>
 <p> 
 For automated analysis, if you are doing NGS analysis and you need to capture
 all possible transcripts, GENCODE provides a comprehensive gene set.  For human 
 genetics or variant annotation, a more restricted transcript set is usually sufficient and &quot;NCBI
 RefSeq&quot; is the standard. If you are only interested in protein-coding
 annotations, CCDS or UniProt may be an option, but this is rather unusual.
 </p>
 
 <p>
 For manual inspection of exon boundaries of a single gene, and especially if it
 is a transcript that is repetitive or hard to align (e.g. very small exons),
 look at the UCSC RefSeq track and watch for differences between the NCBI
 and UCSC exon placement. You can also BLAT the transcript sequence. 
 Manually look at ESTs, mRNAs, TransMap and possibly Augustus, Genscan, SIB, SGP
 or GeneId in obscure cases where you are looking for hints on what an
-alternative splicing could look like.
+alternative splicing could look like.</p>
+<p>
+You may also find the <a target="_blank" 
+href="http://genome.ucsc.edu/s/view/GeneSupport">Gene Support</a> public session
+helpful. This session is a collection of tracks centered around supporting evidence
+for genes.</p>
 </p>
 
 <!--#include virtual="$ROOT/inc/gbPageEnd.html" -->