Updating stylesheets and about page after receiving feedback.

author: Pjotr Prins 2020-07-18 09:28:03 +0100
committer: Pjotr Prins 2020-07-18 09:28:36 +0100
commit: fe8129b37d8b6787920a21f9961316747b62fb30 (patch)
tree: cad53f7dcbfedd419b9a91254b5d887531fcbf86 /doc
parent: 6e6afb4b6be3f2f2c1b8b56d85d8c2089f709d26 (diff)
download: bh20-seq-resource-fe8129b37d8b6787920a21f9961316747b62fb30.tar.gz
bh20-seq-resource-fe8129b37d8b6787920a21f9961316747b62fb30.tar.lz
bh20-seq-resource-fe8129b37d8b6787920a21f9961316747b62fb30.zip
2 files changed, 119 insertions, 76 deletions
diff --git a/doc/web/about.html b/doc/web/about.html
index 9b16c92..dfd4252 100644
--- a/doc/web/about.html
+++ b/doc/web/about.html
@@ -3,7 +3,7 @@
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 <head>
-<!-- 2020-07-12 Sun 06:29 -->
+<!-- 2020-07-18 Sat 03:27 -->
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>About/FAQ</title>
@@ -161,6 +161,19 @@
   .footdef  { margin-bottom: 1em; }
   .figure { padding: 1em; }
   .figure p { text-align: center; }
+  .equation-container {
+    display: table;
+    text-align: center;
+    width: 100%;
+  }
+  .equation {
+    vertical-align: middle;
+  }
+  .equation-label {
+    display: table-cell;
+    text-align: right;
+    vertical-align: middle;
+  }
   .inlinetask {
     padding: 10px;
     border: 2px solid gray;
@@ -185,7 +198,7 @@
 @licstart  The following is the entire license notice for the
 JavaScript code in this tag.
 
-Copyright (C) 2012-2018 Free Software Foundation, Inc.
+Copyright (C) 2012-2020 Free Software Foundation, Inc.
 
 The JavaScript code in this tag is free software: you can
 redistribute it and/or modify it under the terms of the GNU
@@ -234,29 +247,30 @@ for the JavaScript code in this tag.
 <h2>Table of Contents</h2>
 <div id="text-table-of-contents">
 <ul>
-<li><a href="#orgac6ad8b">1. What is the 'public sequence resource' about?</a></li>
-<li><a href="#org0c21c2e">2. Who created the public sequence resource?</a></li>
-<li><a href="#org3fb8cb3">3. How does the public sequence resource compare to other data resources?</a></li>
-<li><a href="#org6cd9ea2">4. Why should I upload my data here?</a></li>
-<li><a href="#org0b6e3fb">5. Why should I not upload by data here?</a></li>
-<li><a href="#org3eb3a4e">6. How does the public sequence resource work?</a></li>
-<li><a href="#org7a397f5">7. Who uses the public sequence resource?</a></li>
-<li><a href="#org92cb008">8. Is this about open data?</a></li>
-<li><a href="#org232d6fa">9. Is this about free software?</a></li>
-<li><a href="#orgd93869f">10. How do I upload raw data?</a></li>
-<li><a href="#org88e8b0a">11. How do I change metadata?</a></li>
-<li><a href="#orgd04b8f8">12. How do I change the work flows?</a></li>
-<li><a href="#org5d1ee05">13. How do I change the source code?</a></li>
-<li><a href="#orgae6461b">14. Should I choose CC-BY or CC0?</a></li>
-<li><a href="#org3ea90a9">15. How do I deal with private data and privacy?</a></li>
-<li><a href="#org7ff7106">16. How do I communicate with you?</a></li>
-<li><a href="#org9566fa7">17. Who are the sponsors?</a></li>
+<li><a href="#org0db9061">1. What is the 'public sequence resource' about?</a></li>
+<li><a href="#org983877d">2. Who created the public sequence resource?</a></li>
+<li><a href="#org83093c3">3. How does the public sequence resource compare to other data resources?</a></li>
+<li><a href="#org9b31fd4">4. Why should I upload my data here?</a></li>
+<li><a href="#org4e92cb5">5. Why should I not upload by data here?</a></li>
+<li><a href="#orgdfe72f6">6. How does the public sequence resource work?</a></li>
+<li><a href="#orgd0c5abb">7. Who uses the public sequence resource?</a></li>
+<li><a href="#org56f4a54">8. How can I contribute?</a></li>
+<li><a href="#org2240ef7">9. Is this about open data?</a></li>
+<li><a href="#orgbb655e0">10. Is this about free software?</a></li>
+<li><a href="#org4e779f4">11. How do I upload raw data?</a></li>
+<li><a href="#org83f6b7b">12. How do I change metadata?</a></li>
+<li><a href="#org1bc6dab">13. How do I change the work flows?</a></li>
+<li><a href="#org1140d62">14. How do I change the source code?</a></li>
+<li><a href="#orge182714">15. Should I choose CC-BY or CC0?</a></li>
+<li><a href="#orgf4a692b">16. How do I deal with private data and privacy?</a></li>
+<li><a href="#org7757574">17. How do I communicate with you?</a></li>
+<li><a href="#org194006f">18. Who are the sponsors?</a></li>
 </ul>
 </div>
 </div>
 
-<div id="outline-container-orgac6ad8b" class="outline-2">
-<h2 id="orgac6ad8b"><span class="section-number-2">1</span> What is the 'public sequence resource' about?</h2>
+<div id="outline-container-org0db9061" class="outline-2">
+<h2 id="org0db9061"><span class="section-number-2">1</span> What is the 'public sequence resource' about?</h2>
 <div class="outline-text-2" id="text-1">
 <p>
 The <b>public sequence resource</b> aims to provide a generic and useful
@@ -267,8 +281,8 @@ sequence comparison and protein prediction.
 </div>
 </div>
 
-<div id="outline-container-org0c21c2e" class="outline-2">
-<h2 id="org0c21c2e"><span class="section-number-2">2</span> Who created the public sequence resource?</h2>
+<div id="outline-container-org983877d" class="outline-2">
+<h2 id="org983877d"><span class="section-number-2">2</span> Who created the public sequence resource?</h2>
 <div class="outline-text-2" id="text-2">
 <p>
 The <b>public sequence resource</b> is an initiative by <a href="https://github.com/arvados/bh20-seq-resource/graphs/contributors">bioinformatics</a> and
@@ -289,14 +303,17 @@ wrangling experts. Thank you everyone!
 </div>
 </div>
 
-<div id="outline-container-org3fb8cb3" class="outline-2">
-<h2 id="org3fb8cb3"><span class="section-number-2">3</span> How does the public sequence resource compare to other data resources?</h2>
+<div id="outline-container-org83093c3" class="outline-2">
+<h2 id="org83093c3"><span class="section-number-2">3</span> How does the public sequence resource compare to other data resources?</h2>
 <div class="outline-text-2" id="text-3">
 <p>
 The short version is that we use state-of-the-art practices in
 bioinformatics using agile methods. Unlike the resources from large
 institutes we can improve things on a dime and anyone can contribute
-to building out this resource!
+to building out this resource! Sequences from GenBank, EBI/ENA and
+others are regularly added to PubSeq. We encourage people to everyone
+to submit on PubSeq because of its superior live tooling and metadata
+support (see the next question).
 </p>
 
 <p>
@@ -305,13 +322,13 @@ Importantly: all data is published under either the <a href="https://creativecom
 means it data can be published and workflows can run in public
 environments allowing for improved access for research and
 reproducible results. This contrasts with some other public resources,
-including GISAID.
+such as GISAID.
 </p>
 </div>
 </div>
 
-<div id="outline-container-org6cd9ea2" class="outline-2">
-<h2 id="org6cd9ea2"><span class="section-number-2">4</span> Why should I upload my data here?</h2>
+<div id="outline-container-org9b31fd4" class="outline-2">
+<h2 id="org9b31fd4"><span class="section-number-2">4</span> Why should I upload my data here?</h2>
 <div class="outline-text-2" id="text-4">
 <ol class="org-ol">
 <li>We champion truly shareable data without licensing restrictions - with proper
@@ -335,15 +352,15 @@ Bioinformatics COVID-19 knowledge base
 
 <p>
 Finally, if you upload your data here we have workflows that output
-formatted data suitable for uploading to EBI resources (and soon
+formatted data suitable for <a href="http://covid19.genenetwork.org/blog?id=using-covid-19-pubseq-part6">uploading to EBI resources</a> (and soon
 others). Uploading your data here get your data ready for upload to
 multiple resources.
 </p>
 </div>
 </div>
 
-<div id="outline-container-org0b6e3fb" class="outline-2">
-<h2 id="org0b6e3fb"><span class="section-number-2">5</span> Why should I not upload by data here?</h2>
+<div id="outline-container-org4e92cb5" class="outline-2">
+<h2 id="org4e92cb5"><span class="section-number-2">5</span> Why should I not upload by data here?</h2>
 <div class="outline-text-2" id="text-5">
 <p>
 Funny question.  There are only good reasons to upload your data here
@@ -365,8 +382,8 @@ for bulk uploads!
 </div>
 </div>
 
-<div id="outline-container-org3eb3a4e" class="outline-2">
-<h2 id="org3eb3a4e"><span class="section-number-2">6</span> How does the public sequence resource work?</h2>
+<div id="outline-container-orgdfe72f6" class="outline-2">
+<h2 id="orgdfe72f6"><span class="section-number-2">6</span> How does the public sequence resource work?</h2>
 <div class="outline-text-2" id="text-6">
 <p>
 On uploading a sequence with metadata it will automatically be
@@ -377,8 +394,8 @@ using workflows from the High Performance Open Biology Lab defined
 </div>
 </div>
 
-<div id="outline-container-org7a397f5" class="outline-2">
-<h2 id="org7a397f5"><span class="section-number-2">7</span> Who uses the public sequence resource?</h2>
+<div id="outline-container-orgd0c5abb" class="outline-2">
+<h2 id="orgd0c5abb"><span class="section-number-2">7</span> Who uses the public sequence resource?</h2>
 <div class="outline-text-2" id="text-7">
 <p>
 The Swiss Institute of Bioinformatics has included this data in
@@ -390,16 +407,29 @@ The Pantograph <a href="https://graph-genome.github.io/">viewer</a> uses PubSeq
 </p>
 
 <p>
-<a href="https://uthsc.edu">UTHSC</a> and <a href="https://www.ornl.gov/news/ornl-fight-against-covid-19">ORNL</a> use COVID-19 PubSeq data for protein prediction and
-drug development.
+<a href="https://uthsc.edu">UTHSC</a> (USA), <a href="https://www.esr.cri.nz/">ESR</a> (New Zealand) and <a href="https://www.ornl.gov/news/ornl-fight-against-covid-19">ORNL</a> (USA) use COVID-19 PubSeq data
+for monitoring, protein prediction and drug development.
 </p>
 </div>
 </div>
 
-<div id="outline-container-org92cb008" class="outline-2">
-<h2 id="org92cb008"><span class="section-number-2">8</span> Is this about open data?</h2>
+<div id="outline-container-org56f4a54" class="outline-2">
+<h2 id="org56f4a54"><span class="section-number-2">8</span> How can I contribute?</h2>
 <div class="outline-text-2" id="text-8">
 <p>
+You can contribute by submitting sequences, updating metadata, submit
+issues on our issue tracker, and more importantly add functionality.
+See 'How do I change the source code' below. Read through our online
+documentation at <a href="http://covid19.genenetwork.org/blog">http://covid19.genenetwork.org/blog</a> as a starting
+point.
+</p>
+</div>
+</div>
+
+<div id="outline-container-org2240ef7" class="outline-2">
+<h2 id="org2240ef7"><span class="section-number-2">9</span> Is this about open data?</h2>
+<div class="outline-text-2" id="text-9">
+<p>
 All data is published under a <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons 4.0 attribution license</a>
 (CC-BY-4.0). You can download the raw and published (GFA/RDF/FASTA)
 data and store it for further processing.
@@ -407,9 +437,9 @@ data and store it for further processing.
 </div>
 </div>
 
-<div id="outline-container-org232d6fa" class="outline-2">
-<h2 id="org232d6fa"><span class="section-number-2">9</span> Is this about free software?</h2>
-<div class="outline-text-2" id="text-9">
+<div id="outline-container-orgbb655e0" class="outline-2">
+<h2 id="orgbb655e0"><span class="section-number-2">10</span> Is this about free software?</h2>
+<div class="outline-text-2" id="text-10">
 <p>
 Absolutely. Free software allows for fully reproducible pipelines. You
 can take our workflows and data and run it elsewhere!
@@ -417,9 +447,9 @@ can take our workflows and data and run it elsewhere!
 </div>
 </div>
 
-<div id="outline-container-orgd93869f" class="outline-2">
-<h2 id="orgd93869f"><span class="section-number-2">10</span> How do I upload raw data?</h2>
-<div class="outline-text-2" id="text-10">
+<div id="outline-container-org4e779f4" class="outline-2">
+<h2 id="org4e779f4"><span class="section-number-2">11</span> How do I upload raw data?</h2>
+<div class="outline-text-2" id="text-11">
 <p>
 We are preparing raw sequence data pipelines (fastq and BAM). The
 reason is that we want the best data possible for downstream analysis
@@ -433,27 +463,28 @@ assembly variations into consideration. This is all work in progress.
 </div>
 </div>
 
-<div id="outline-container-org88e8b0a" class="outline-2">
-<h2 id="org88e8b0a"><span class="section-number-2">11</span> How do I change metadata?</h2>
-<div class="outline-text-2" id="text-11">
+<div id="outline-container-org83f6b7b" class="outline-2">
+<h2 id="org83f6b7b"><span class="section-number-2">12</span> How do I change metadata?</h2>
+<div class="outline-text-2" id="text-12">
 <p>
 See the <a href="http://covid19.genenetwork.org/blog">http://covid19.genenetwork.org/blog</a>!
 </p>
 </div>
 </div>
 
-<div id="outline-container-orgd04b8f8" class="outline-2">
-<h2 id="orgd04b8f8"><span class="section-number-2">12</span> How do I change the work flows?</h2>
-<div class="outline-text-2" id="text-12">
+<div id="outline-container-org1bc6dab" class="outline-2">
+<h2 id="org1bc6dab"><span class="section-number-2">13</span> How do I change the work flows?</h2>
+<div class="outline-text-2" id="text-13">
 <p>
-See the <a href="http://covid19.genenetwork.org/blog">http://covid19.genenetwork.org/blog</a>!
+Workflows are on <a href="https://github.com/arvados/bh20-seq-resource/tree/master/workflows">github</a> and can be modified. See also the BLOG
+<a href="http://covid19.genenetwork.org/blog">http://covid19.genenetwork.org/blog</a> on workflows.
 </p>
 </div>
 </div>
 
-<div id="outline-container-org5d1ee05" class="outline-2">
-<h2 id="org5d1ee05"><span class="section-number-2">13</span> How do I change the source code?</h2>
-<div class="outline-text-2" id="text-13">
+<div id="outline-container-org1140d62" class="outline-2">
+<h2 id="org1140d62"><span class="section-number-2">14</span> How do I change the source code?</h2>
+<div class="outline-text-2" id="text-14">
 <p>
 Go to our <a href="https://github.com/arvados/bh20-seq-resource">source code repositories</a>, fork/clone the repository, change
 something and submit a <a href="https://github.com/arvados/bh20-seq-resource/pulls">pull request</a> (PR). That easy! Check out how
@@ -462,9 +493,9 @@ many PRs we already merged.
 </div>
 </div>
 
-<div id="outline-container-orgae6461b" class="outline-2">
-<h2 id="orgae6461b"><span class="section-number-2">14</span> Should I choose CC-BY or CC0?</h2>
-<div class="outline-text-2" id="text-14">
+<div id="outline-container-orge182714" class="outline-2">
+<h2 id="orge182714"><span class="section-number-2">15</span> Should I choose CC-BY or CC0?</h2>
+<div class="outline-text-2" id="text-15">
 <p>
 Restrictive data licenses are hampering data sharing and reproducible
 research. CC0 is the preferred license because it gives researchers
@@ -479,9 +510,9 @@ In all honesty: we prefer both data and software to be free.
 </div>
 </div>
 
-<div id="outline-container-org3ea90a9" class="outline-2">
-<h2 id="org3ea90a9"><span class="section-number-2">15</span> How do I deal with private data and privacy?</h2>
-<div class="outline-text-2" id="text-15">
+<div id="outline-container-orgf4a692b" class="outline-2">
+<h2 id="orgf4a692b"><span class="section-number-2">16</span> How do I deal with private data and privacy?</h2>
+<div class="outline-text-2" id="text-16">
 <p>
 A public sequence resource is about public data. Metadata can refer to
 private data. You can use your own (anonymous) identifiers.  We also
@@ -491,18 +522,18 @@ plan to combine identifiers with clinical data stored securely at
 </div>
 </div>
 
-<div id="outline-container-org7ff7106" class="outline-2">
-<h2 id="org7ff7106"><span class="section-number-2">16</span> How do I communicate with you?</h2>
-<div class="outline-text-2" id="text-16">
+<div id="outline-container-org7757574" class="outline-2">
+<h2 id="org7757574"><span class="section-number-2">17</span> How do I communicate with you?</h2>
+<div class="outline-text-2" id="text-17">
 <p>
 We use a <a href="https://gitter.im/arvados/pubseq?utm_source=share-link&amp;utm_medium=link&amp;utm_campaign=share-link">gitter channel</a> you can join.
 </p>
 </div>
 </div>
 
-<div id="outline-container-org9566fa7" class="outline-2">
-<h2 id="org9566fa7"><span class="section-number-2">17</span> Who are the sponsors?</h2>
-<div class="outline-text-2" id="text-17">
+<div id="outline-container-org194006f" class="outline-2">
+<h2 id="org194006f"><span class="section-number-2">18</span> Who are the sponsors?</h2>
+<div class="outline-text-2" id="text-18">
 <p>
 The main sponsors are listed in the footer. In addition to the time
 generously donated by many contributors we also acknowledge Amazon AWS
@@ -512,7 +543,7 @@ for donating COVID-19 related compute time.
 </div>
 </div>
 <div id="postamble" class="status">
-<hr><small>Created by <a href="http://thebird.nl/">Pjotr Prins</a> (pjotr.public768 at thebird 'dot' nl) using Emacs org-mode and a healthy dose of Lisp!<br />Modified 2020-07-12 Sun 04:54</small>.
+<hr><small>Created by <a href="http://thebird.nl/">Pjotr Prins</a> (pjotr.public768 at thebird 'dot' nl) using Emacs org-mode and a healthy dose of Lisp!<br />Modified 2020-07-18 Sat 03:27</small>.
 </div>
 </body>
 </html>
diff --git a/doc/web/about.org b/doc/web/about.org
index 1949e2d..39fb667 100644
--- a/doc/web/about.org
+++ b/doc/web/about.org
@@ -9,6 +9,7 @@
  - [[#why-should-i-not-upload-by-data-here][Why should I not upload by data here?]]
  - [[#how-does-the-public-sequence-resource-work][How does the public sequence resource work?]]
  - [[#who-uses-the-public-sequence-resource][Who uses the public sequence resource?]]
+ - [[#how-can-i-contribute][How can I contribute?]]
  - [[#is-this-about-open-data][Is this about open data?]]
  - [[#is-this-about-free-software][Is this about free software?]]
  - [[#how-do-i-upload-raw-data][How do I upload raw data?]]
@@ -47,14 +48,17 @@ wrangling experts. Thank you everyone!
 The short version is that we use state-of-the-art practices in
 bioinformatics using agile methods. Unlike the resources from large
 institutes we can improve things on a dime and anyone can contribute
-to building out this resource!
+to building out this resource! Sequences from GenBank, EBI/ENA and
+others are regularly added to PubSeq. We encourage people to everyone
+to submit on PubSeq because of its superior live tooling and metadata
+support (see the next question).
 
 Importantly: all data is published under either the [[https://creativecommons.org/licenses/by/4.0/][Creative Commons
 4.0 attribution license]] or the [[https://creativecommons.org/share-your-work/public-domain/cc0/][CC0 “No Rights Reserved” license]] which
 means it data can be published and workflows can run in public
 environments allowing for improved access for research and
 reproducible results. This contrasts with some other public resources,
-including GISAID.
+such as GISAID.
 
 * Why should I upload my data here?
 
@@ -77,7 +81,7 @@ including GISAID.
 4. Your data will be used to develop drug targets
 
 Finally, if you upload your data here we have workflows that output
-formatted data suitable for uploading to EBI resources (and soon
+formatted data suitable for [[http://covid19.genenetwork.org/blog?id=using-covid-19-pubseq-part6][uploading to EBI resources]] (and soon
 others). Uploading your data here get your data ready for upload to
 multiple resources.
 
@@ -109,8 +113,16 @@ https://covid-19-sparql.expasy.org/ and made it part of [[https://www.uniprot.or
 
 The Pantograph [[https://graph-genome.github.io/][viewer]] uses PubSeq data for their visualisations.
 
-[[https://uthsc.edu][UTHSC]] and [[https://www.ornl.gov/news/ornl-fight-against-covid-19][ORNL]] use COVID-19 PubSeq data for protein prediction and
-drug development.
+[[https://uthsc.edu][UTHSC]] (USA), [[https://www.esr.cri.nz/][ESR]] (New Zealand) and [[https://www.ornl.gov/news/ornl-fight-against-covid-19][ORNL]] (USA) use COVID-19 PubSeq data
+for monitoring, protein prediction and drug development.
+
+* How can I contribute?
+
+You can contribute by submitting sequences, updating metadata, submit
+issues on our issue tracker, and more importantly add functionality.
+See 'How do I change the source code' below. Read through our online
+documentation at http://covid19.genenetwork.org/blog as a starting
+point.
 
 * Is this about open data?
 
@@ -140,8 +152,8 @@ See the [[http://covid19.genenetwork.org/blog]]!
 
 * How do I change the work flows?
 
-Workflows are on [[https://github.com/arvados/bh20-seq-resource/tree/master/workflows][github]] and can be modified. See also the
-[[[[http://covid19.genenetwork.org/blog]]][workflow blog]].
+Workflows are on [[https://github.com/arvados/bh20-seq-resource/tree/master/workflows][github]] and can be modified. See also the BLOG
+[[http://covid19.genenetwork.org/blog]] on workflows.
 
 * How do I change the source code?
author	Pjotr Prins	2020-07-18 09:28:03 +0100
committer	Pjotr Prins	2020-07-18 09:28:36 +0100
commit	fe8129b37d8b6787920a21f9961316747b62fb30 (patch)
tree	cad53f7dcbfedd419b9a91254b5d887531fcbf86 /doc
parent	6e6afb4b6be3f2f2c1b8b56d85d8c2089f709d26 (diff)
download	bh20-seq-resource-fe8129b37d8b6787920a21f9961316747b62fb30.tar.gz bh20-seq-resource-fe8129b37d8b6787920a21f9961316747b62fb30.tar.lz bh20-seq-resource-fe8129b37d8b6787920a21f9961316747b62fb30.zip