Details pages -- conventions: Difference between revisions

From Genecats
Jump to navigationJump to search
No edit summary
No edit summary
Line 13: Line 13:
#  Links to pages outside of the Genome Browser should open in a new window.
#  Links to pages outside of the Genome Browser should open in a new window.
#  Do not include punctuation in link names.  For example:
#  Do not include punctuation in link names.  For example:
   >link name</a>.
   target="_blank">link name</a>.
not
not
   >link name.</a>
   target="_blank">link name.</a>
# Links to our own SOE pages should use ".soe." in the URL, not ".cse."  E.g., http://hgdownload.soe.ucsc.edu/
# Links to our own SOE pages should use ".soe." in the URL, not ".cse."  E.g., http://hgdownload.soe.ucsc.edu/


Line 27: Line 27:
<B>References</B>
<B>References</B>


#  All references to websites not in our domain require the TARGET = _BLANK tag.
#  All references to websites not in our domain require the <code>target="_blank"</code> that will open a new tab for the reference.
#  Papers are referenced with outlinks in one place at the bottom of the page only, not in the text above.  In the text we simply say something like "Euskirchen, <EM> et al.</EM>, 2007".  Particularly if the paper is in preprint or Epub, we then only have to change the ref in one place.
#  Papers are referenced with outlinks in one place at the bottom of the page only, not in the text above.  In the text we simply say something like "Euskirchen, <EM> et al.</EM>, 2007".  Particularly if the paper is in preprint or Epub, we then only have to change the ref in one place.
#  Refs are in PubMed format (see [[CBSE_citation_format]]).
#  Refs are in PubMed format (see [[CBSE_citation_format]]).
#  Refs with many authors are truncated to 10 authors and ''et al'' (which should be italicized).
#  Refs with many authors are truncated to 10 authors and ''et al'' (which should be italicized).
#  Refs are in alphabetical order by first author's last name.
#  Refs are in alphabetical order by first author's last name.

Revision as of 18:19, 18 August 2016


Details pages should be consistent from track to track. To ease the burden on QA, developers are requested to:

  1. Keep lines in the source page to 100 characters or less.
  2. Try to use lowercase html, <a>...</a> versus upper-case <A>...</A>. It is OK if an older page has mixed types.
  3. Quotes, ampersands, less than and greater than signs, and degree symbols should be represented with their [html names]. For example &quot; for " and &amp; for & and &lt; for < and &gt; for > and &deg; for °.
  4. Email addresses should go through Hiram's sanitizer (encodeEmail.pl). It turns the address into an encrypted HREF "mailto:" address that makes it harder for spammers to use.
  5. The "Display Conventions and Configuration" section should cover all track types.
  6. For ENCODE tracks, the page should include contact information for the submitting lab.
  7. Links to pages outside of the Genome Browser should open in a new window.
  8. Do not include punctuation in link names. For example:
 target="_blank">link name</a>.

not

 target="_blank">link name.</a>
  1. Links to our own SOE pages should use ".soe." in the URL, not ".cse." E.g., http://hgdownload.soe.ucsc.edu/

Grammar/punctuation notes:

  1. Units should be separated from the numbers by a space: "200 bp", not "200bp".
  2. We are using data as a plural noun. "Data are" not "Data is."
  3. "It's" means "It is." "Its" is possessive.
  4. Use American spellings: analyze, minimize, color, etc.

References

  1. All references to websites not in our domain require the target="_blank" that will open a new tab for the reference.
  2. Papers are referenced with outlinks in one place at the bottom of the page only, not in the text above. In the text we simply say something like "Euskirchen, et al., 2007". Particularly if the paper is in preprint or Epub, we then only have to change the ref in one place.
  3. Refs are in PubMed format (see CBSE_citation_format).
  4. Refs with many authors are truncated to 10 authors and et al (which should be italicized).
  5. Refs are in alphabetical order by first author's last name.