Browse Source

Major rules overhaul

pjc 5 years ago
parent
commit
21f181197a
1 changed files with 229 additions and 247 deletions
  1. 229
    247
      sections/rules/upload.php

+ 229
- 247
sections/rules/upload.php View File

@@ -20,17 +20,11 @@ View::show_header('Uploading Rules', 'rules');
20 20
       <ul>
21 21
         <li id="Introk"><a href="#Intro"><strong>Introduction</strong></a></li>
22 22
         <li id="defk"><a href="#def"><strong>Definitions</strong></a></li>
23
-        <li id="h1k"><a href="#h1">1. <strong>Content Rules</strong></a>
23
+        <li id="hUk"><a href="#hU"><strong>Upload Rules</strong></a>
24 24
           <ul>
25
-            <li id="h1.1k"><a href="#h1.1">1.1. <strong>General</strong></a></li>
26
-            <li id="h1.2k"><a href="#h1.2">1.2. <strong>Formatting</strong></a></li>
27
-            <li id="h1.3k"><a href="#h1.3">1.3. <strong>Specifically Banned</strong></a></li>
28
-          </ul>
29
-        </li>
30
-        <li id="h2k"><a href="#h2">2. <strong>Site Rules</strong></a>
31
-          <ul>
32
-            <li id="h2.1k"><a href="#h2.1">2.1. <strong>Upload Form Walkthrough</strong></a></li>
33
-            <li id="h2.2k"><a href="#h2.2">2.2. <strong>Duplicates and Trumping</strong></a></li>
25
+            <li id="h1.1k"><a href="#h1.1">1.1 <strong>General and Formatting</strong></a></li>
26
+            <li id="h2.2k"><a href="#h1.2">1.2 <strong>Duplicates and Trumping</strong></a></li>
27
+            <li id="h2.1k"><a href="#h1.3">1.3 <strong>Upload Form Walkthrough</strong></a></li>
34 28
           </ul>
35 29
         </li>
36 30
       </ul>
@@ -53,370 +47,358 @@ View::show_header('Uploading Rules', 'rules');
53 47
         <p>
54 48
           Please read this entire page carefully because it explains how the tracker organizes the content.
55 49
           Referring to this page often will help you search faster and upload smarter.
56
-          I'll go line-by-line through <a href="upload.php">the upload form</a>.
50
+          I'll also go line-by-line through <a href="upload.php">the upload form</a>.
57 51
         </p>
58 52
 
59 53
         <p>
60 54
           Thanks for taking an interest in this project and contributing to its success.
61
-          Please note that <?= SITE_NAME ?> isn't a piracy site and only allows permissively licensed datasets.
55
+          Please note that <?= SITE_NAME ?> isn't a pirate website.
62 56
         </p>
63 57
         </div>
64 58
 
65 59
       <h4 id="def"><a href="#defk"><strong>&uarr;</strong></a> Definitions</h4>
66 60
       <div class="box pad" style="padding: 10px 10px 10px 20px;">
67 61
         <ul>
68
-          <li><b>Torrent</b> - Broadly used as a noun to describe a <code>.torrent</code> file, the files associated with it, and any associated metadata indexed by the site. Used as a verb to describe the act of downloading or uploading data from or to the swarm.</li>
69
-          <li><b>Swarm</b> - All peers associated with a given torrent.</li>
70
-          <li><b>Peer</b> - A client that has announced to the tracker and is part of the swarm.</b>
71
-          <li><b>Seed</b> - When used as a verb, describes the act of uploading torrent content to other peers. When used as a noun, describes a peer who has all of content associated with a torrent as is able to upload to peers. Sometimes referred to as a seeder.</li>
72
-          <li><b>Leech</b> - When used as a verb, describes the act of downloading torrent content from another peer. When used as a noun, describes someone who is downloading or wants to download torrent content from another peer. Sometimes referred to as a leecher.</li>
73
-          <li><b>Metadata</b> - The information we record here on the site for each torrent, such as title, encoding information, and tags.</li>
74
-          <li><b>Hentai</b> - A subgenre of anime, manga, and games characterized by being pornographic.</li>
62
+          <li><b>Torrent.</b> Broadly used as a noun to describe a <code>.torrent</code> file, the files associated with it, and any associated metadata indexed by the site. Used as a verb to describe the act of downloading or uploading data from or to the swarm.</li>
63
+          <li><b>Swarm.</b> All peers associated with a given torrent.</li>
64
+          <li><b>Peer.</b> A client that has announced to the tracker and is part of the swarm.</b>
65
+          <li><b>Seed.</b> When used as a verb, describes the act of uploading torrent content to other peers. When used as a noun, describes a peer who has all of content associated with a torrent as is able to upload to peers. Sometimes referred to as a seeder.</li>
66
+          <li><b>Leech.</b> When used as a verb, describes the act of downloading torrent content from another peer. When used as a noun, describes someone who is downloading or wants to download torrent content from another peer. Sometimes referred to as a leecher.</li>
67
+          <li><b>Metadata.</b> The information we record here on the site for each torrent, such as title, encoding information, and tags.</li>
68
+          <li><b>Hentai.</b> A subgenre of anime, manga, and games characterized by being pornographic.</li>
75 69
         </ul>
76 70
       </div>
77 71
     </div>
78 72
 
79
-    <h4 id="h1"><a href="#h1k"><strong>&uarr;</strong></a> <a href="#h1">1.</a> Content Rules</h4>
80
-      <h5 id="h1.1"><a href="#h1.1k"><strong>&uarr;</strong></a> <a href="#h1.1">1.1.</a> General</h5>
73
+    <h4 id="hU"><a href="#hUk"><strong>&uarr;</strong></a> <a href="#hU"></a> Upload Rules</h4>
74
+      <h5 id="h1"><a href="#h1k"><strong>&uarr;</strong></a> <a href="#h1">1</a> General and Formatting</h5>
81 75
         <div class="box pad" style="padding: 10px 10px 10px 20px;">
82 76
           <ul>
83
-            <li id="r1.1.1"><a href="#h1.1"><strong>&uarr;</strong></a> <a href="#r1.1.1">1.1.1.</a>
84
-              <strong>Only biological sequences and medical imaging data are allowed on the site.</strong>
85
-              <?=SITE_NAME?> is an annotated repository.
86
-              The only expections to this rule live in the Other category, which is explained in its own section.
87
-            </li>
88
-
89
-            <li id="r1.1.2"><a href="#h1.1"><strong>&uarr;</strong></a> <a href="#r1.1.2">1.1.2.</a>
90
-              <strong>Duplicate torrents in any category are not allowed.</strong>
91
-              There are some exceptions to this rule, which are outlined in their relevant sections below.
92
-            </li>
93
-
94
-            <li id="r1.1.3"><a href="#h1.1"><strong>&uarr;</strong></a> <a href="#r1.1.3">1.1.3.</a>
95
-              <strong>Seed complete copies of your uploads.</strong>
96
-              Do not upload a torrent unless you intend to seed until there are at least 1.0 distributed copies. Seeding past this minimum is strongly encouraged.
97
-            </li>
98
-
99
-            <li id="r1.1.4"><a href="#h1.1"><strong>&uarr;</strong></a> <a href="#r1.1.4">1.1.4.</a>
100
-              <strong>No advertising or personal credits.</strong>
101
-              Providing author, lab, or other information is not considered advertising.
77
+            <li id="r1.1"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.1">1.1</a>
78
+              <strong>Biology Only.</strong>
79
+              <?=SITE_NAME?> is an annotated repository of biology data and a bioinformatics learning community.
80
+              Gazelle in its current state requires lots of hardcoded metadata.
81
+              I can help you adapt the design, e.g., for physics or astronomy data.
82
+              A generalized science tracker is in development.
83
+            </li>
84
+
85
+            <li id="r1.2"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.2">1.2</a>
86
+              <strong>Seed Forever.</strong>
87
+              Private torrent trackers succeed when they offer quality niche content and a comfy interface.
88
+              This isn't an NCBI data dump but a library of annotated info hashes that tomorrow's networks can ingest.
89
+              Do not upload a torrent unless you intend to seed until there are at least 3 copies.
90
+              Three is a good minimum swarm size.
91
+            </li>
92
+
93
+            <li id="r1.3"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.3">1.3</a>
94
+              <strong>No Advertising.</strong>
95
+              Please don't "tag" torrents, include ASCII art, or make your torrents look like they came from the Pirate Bay.
96
+              These kinds of additions are allowed if they serve a relevant purpose.
97
+              Enclosing a GPG-signed hash of your data isn't a bad idea at all. 
102 98
               <ul>
103
-
104
-                <li id="r1.1.4.1"><a href="#h1.1.4"><strong>&uarr;</strong></a> <a href="#r1.1.4.1">1.1.4.1</a>
105
-                  <strong>Do not advertise sites, groups, or persons in torrent contents (e.g., folder names, file names, or file tags).</strong>
106
-                </li>
107
-
108
-                <li id="r1.1.4.2"><a href="#h1.1.4"><strong>&uarr;</strong></a> <a href="#r1.1.4.2">1.1.4.2</a>
109
-                  <strong>Do not advertise sites, groups, or persons in torrent descriptions.</strong>
110
-                </li>
111 99
               </ul>
112 100
             </li>
113 101
 
114
-            <li id="r1.1.5"><a href="#h1.1"><strong>&uarr;</strong></a> <a href="#r1.1.5">1.1.5.</a>
115
-              <strong>Archived files in uploads under 2 GiB are not allowed.</strong>
116
-              Specific archival rules can be found in their respective sections.
117
-            </li>
118
-
119
-            <li id="r1.1.6"><a href="#h1.1"><strong>&uarr;</strong></a> <a href="#r1.1.6">1.1.6.</a>
120
-              <strong>English is the language of <?=SITE_NAME?>.</strong>
121
-              The data folder structure should correspond to its English labels on <?= SITE_NAME ?> whenever possible.
102
+            <li id="r1.4"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.4">1.4</a>
103
+              <strong>Speak English.</strong>
104
+              <?=SITE_NAME?> is an Anglophone site.
105
+              Everything but private messages, and especially torrents and the forums, should be in English.
122 106
             </li>
123 107
 
124
-            <li id="r1.1.7"><a href="#h1.1"><strong>&uarr;</strong></a> <a href="#r1.1.7">1.1.7.</a>
125
-              <strong>Watermarked uploads are allowed,</strong>
126
-              however they may be trumpable by non-watermarked uploads (see <a href="#r2.2.5">rule 2.2.5.</a>).
108
+            <li id="r1.5"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.5">1.5</a>
109
+              <strong>Good Data.</strong>
110
+              Strive to release complete collections of the highest fidelity data in the most sensible format.
111
+              Sometimes I wonder whether certain kinds of people are drawn to private torrent trackers, or if the site design encourages otherwise disinterested people to do well.
127 112
             </li>
128 113
 
129
-            <li id="r1.1.8"><a href="#h1.1"><strong>&uarr;</strong></a> <a href="#r1.1.8">1.1.8.</a>
130
-              <strong>No protected archives.</strong>
114
+            <li id="r1.6"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.6">1.6</a>
115
+              <strong>No DRM.</strong>
131 116
               Archived releases must not be password protected.
117
+              DRM of any kind isn't allowed.
132 118
             </li>
133 119
 
134
-            <li id="r1.1.9"><a href="#h1.1"><strong>&uarr;</strong></a> <a href="#r1.1.9">1.1.9.</a>
135
-              <strong>DO NOT PUT METADATA IN THE TITLE FIELD.</strong>
136
-              Metadata should go in the proper fields.
137
-            </li>
138
-          </ul>
139
-        </div>
140
-
141
-      <h5 id="h1.2"><a href="#h1.2k"><strong>&uarr;</strong></a> <a href="#h1.2">1.2.</a> Formatting</h5>
142
-        <div class="box pad" style="padding: 10px 10px 10px 20px;">
143
-          <ul>
144
-            <li id="r1.2.1"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r1.2.1">1.2.1.</a>
145
-              <strong>Torrents must be in a directory that contains the files</strong>
146
-              if there are multiple files.
147
-              Single-file torrents may be uploaded on their own, without a directory.
148
-            </li>
120
+            <hr style="margin: 2em auto; opacity: 0.3; width: 50%;" />
149 121
 
150
-            <li id="r1.2.2"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r1.2.2">1.2.2.</a>
151
-              <strong>Directories should have meaningful titles.</strong>
152
-              "Title - Accession Number" or "Lab - Title."
153
-              The minimum acceptable is "Title," although it is preferable to include more information.
154
-              Uploads that do not follow this rule are trumpable.
155
-            </li>
122
+            <li id="r1.7"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.7">1.7</a>
123
+              <strong>Folder Structure.</strong>
124
+              Each torrent should be a single folder so we can manage them easier.
125
+              Please avoid unnecessary nested folders inside your torrent.
126
+              Use one of the examples below for your main folder.
156 127
 
157
-            <li id="r1.2.3"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r1.2.3">1.2.3.</a>
158
-              <strong>Files within directories should have meaningful names.</strong>
159
-              For uploads containing multiple parts, they should include the part number.
160
-              Torrents that do not follow this rule are trumpable.
161
-            </li>
128
+              <ul>
129
+                <li>One-Shot Project Name</li>
130
+                <li>Torrent Title - Accession Number</li>
131
+                <li>Department/Lab - Project Name</li>
132
+                <li>After the Name - Extra comments as necessary</li>
133
+              </ul>
162 134
 
163
-            <li id="r1.2.4"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.4">2.1.4.</a>
164
-              <strong>Files should sort appropriately.</strong>
165
-              If your upload contains multiple parts, they should sort in the file manager according to the part number (use leading zeroes).
166
-              Torrents that do not follow this rule are trumpable.
135
+              I also strongly recommend you compress only large files or long image series, and not simply compress the entire dataset.
136
+              This makes it easier to partially seed large datasets, work with discrete parts of the data, and know what's on disk.
167 137
             </li>
168 138
 
169
-            <li id="r1.2.5"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r1.2.5">1.2.5.</a>
170
-              <strong>Avoid creating unnecessary nested folders inside your properly named directory.</strong>
171
-              A torrent with unnecessary nested folders is trumpable by a torrent with such folders removed.
172
-              For single-part torrents, all files must be included in the main torrent folder.
173
-              For multi-part torrents, the main torrent folder may include sub-folders that hold the file contents for each of the parts.
139
+            <li id="r1.8"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.8">1.8</a>
140
+              <strong>File Organization.</strong>
141
+              Please either keep the original filenames from the processing service, or consistently use a legible naming scheme.
142
+              Remove all .DS_Store, Thumbs.db, nfo files, and other junk files before making the torrent.
143
+              It should be "clean."
144
+              You're encouraged to keep Git repos, structured data reports, readmes, and other useful annotations.
145
+              Files should sort appropriately: use leading zeroes.
174 146
             </li>
175 147
 
176
-            <li id="r1.2.6"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r1.2.6">1.2.6.</a>
177
-              <strong>Torrents should never have [Req] or [Request] in the title or artist name.</strong>
178
-              If you fill a request using the <a href="requests.php">requests system</a>, everyone who voted for it will be automatically notified.
148
+            <li id="r1.9"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.9">1.9</a>
149
+              <strong>Compression.</strong>
150
+              "10 GiB or 10,000 files."
151
+              Compression is required if your torrent is > 10 GiB or if it contains > 10,000 files.
152
+              Otherwise, please compress text files if it reduces the torrent size by > 30%.
153
+              Never compress torrents < 2 GiB or binary files < 10 GiB.
154
+              Multipart archives are only allowed for torrents > 10 GiB.
179 155
             </li>
180 156
 
181
-            <li id="r1.2.7"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r1.2.7">1.2.7.</a>
182
-            <strong>Torrent titles must accurately reflect the actual titles.</strong>
183
-            Use proper capitalization when giving titles.
184
-            Typing titles in all lowercase letters or all capital letters is unacceptable and makes the torrent trumpable.
185
-            Natural sentence language is best for long titles.
186
-          </li>
187
-
188
-            <li id="r1.2.8"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r1.2.8">1.2.8.</a>
189
-              <strong>The Author field in the torrent name should contain only the author name.</strong>
190
-              Do not add additional information about the author in the author field unless the work credits the author in that manner.
191
-              It is recommended that you search existing torrents for the author name so that you can be sure that you name the author the exact same way.
192
-              A torrent with a proper artist name will be grouped with the existing torrents for that artist on a common artist page, and thus will be easy to find.
193
-              Capitalization problems will also make a torrent trumpable.
194
-              Labeling the author incorrectly prevents your torrent from being grouped with the other torrents for the same author.
157
+            <li id="r1.10"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.10">1.10</a>
158
+              <strong>Metadata.</strong>
159
+              Avoid matching folder names to <?=SITE_NAME?> metadata.
160
+              The site design will change but the torrents are evergreen.
161
+              When What.cd went down, it was possible to seed most of your old torrents at Redacted.ch because the info hashes matched.
162
+              The <code>.torrent</code> points to cryptographically verified folders and files that are tracked for convenience.
163
+              On the flipside, please add enough metadata so that people can pick it out of a list.
195 164
             </li>
196 165
 
197
-            <li id="r1.2.9"><a href="#h1.2"><strong>&uarr;</strong></a> <a href="#r1.2.9">1.2.9.</a>
198
-              <strong>Torrent contents should be clean.</strong>
199
-              Torrents should contain <strong>only</strong> relevant files.
200
-              <strong>Do</strong> include files such as pictures and videos, source code, etc., as long as it belongs to the experimental source of the data or any publications that cite it.
201
-              The exceptions are web releases, which may be uploaded as-released and may contain nfo files and readmes.
202
-              <strong>Don't</strong> put these kinds of files, or anything likely to change independently of the data, in new torrents.
166
+            <li id="r1.11"><a href="#h1"><strong>&uarr;</strong></a> <a href="#r1.11">1.11</a>
167
+              <strong>Supplemental Packs.</strong>
168
+              I strongly recommend <a href="https://semver.org/" target="_blank">Semantic Versioning</a> for your original data.
169
+              Supplemental packs may include a collection of documents, utilities, protocols, metadata, etc., specifically prepared for release.
170
+              The collection should be a separate torrent if the collection constitutes a project in its own right.
171
+              But if you have, e.g., 100 MiB of XML and no other metadata for 5 GB of photos, please include it in the main torrent.
203 172
             </li>
204 173
           </ul>
205 174
         </div>
206 175
 
207
-      <h5 id="h1.3"><a href="#h1.3k"><strong>&uarr;</strong></a> <a href="#h1.3">1.3.</a> Specifically Banned</h5>
176
+        <h5 id="h2"><a href="#h2k"><strong>&uarr;</strong></a> <a href="#h2">2</a> Duplicates and Trumping</h5>
208 177
         <div class="box pad" style="padding: 10px 10px 10px 20px;">
209 178
           <ul>
210
-            <li id="r1.3.1"><a href="#h1.3"><strong>&uarr;</strong></a> <a href="#r1.3.1">1.3.1.</a>
211
-              <strong>Anything not specifically allowed below.</strong> If you have any doubts, ask before uploading.
212
-            </li>
213
-
214
-            <li id="r1.3.2"><a href="#h1.3"><strong>&uarr;</strong></a> <a href="#r1.3.2">1.3.2.</a>
215
-              <strong>Collections of audio files.</strong>
216
-              <?= SITE_NAME ?> doesn't yet support collections of audio files, e.g., non-visual ultrasound data.
217
-            </li>
218
-
219
-            <li id="r1.3.3"><a href="#h1.3"><strong>&uarr;</strong></a> <a href="#r1.3.3">1.3.3.</a>
220
-              <strong>Torrent packs, database rips, etc., are strictly prohibited.</strong>
221
-              They may not be uploaded under any circumstance, e.g., Wikipedia English Official Offline Edition 2014-07-07.
222
-              Torrent "packs" containing mixed samples are allowed if the torrent is under 10 GiB and the data corresponds to one finished experiment.
223
-            </li>
224
-
225
-            <li id="r1.3.4"><a href="#h1.3"><strong>&uarr;</strong></a> <a href="#r1.3.4">1.3.4.</a>
226
-              <strong>DRM-restricted files.</strong>
227
-              Files must not be encrypted or be in a restricted format that impedes sharing.
228
-              You are also highly encouraged to remove personal information from any non-DRM protected files.
229
-            </li>
230
-
231
-            <li id="r1.3.5"><a href="#h1.3"><strong>&uarr;</strong></a> <a href="#r1.3.5">1.3.5.</a>
232
-              <strong>Multi-part archives</strong>
233
-              for torrents under 10 GiB.
234
-            </li>
179
+            <li id="r2.1"><a href="#h2"><strong>&uarr;</strong></a> <a href="#r2.1">2.1</a>
180
+            <strong>Multiple Formats Allowed.</strong>
181
+            It's fine if there's an EMBL and a FASTA of the same data. If you need to convert a dataset for your analysis, please upload a quality conversion with supplemetal info.
182
+            Remember that small, one-shot metadata are better included with the data, and collections of docs and utils are better separate from it.
183
+            If only the header is different and it follows the "10 GiB or 10,000 files" rule, uncompressed torrents trump compressed ones.
184
+            It should be easy for others with the same data to change a line and check out the new torrent.
185
+          </li>
186
+            
187
+          <li id="r2.2"><a href="#h2"><strong>&uarr;</strong></a> <a href="#r2.2">2.2</a>
188
+            <strong>SemVer Trumps.</strong>
189
+            Versioned data can be trumped at the patch level.
190
+            Major and minor releases can coexist.
191
+            Please add a link in the old data's Torrent Group Description to the new data.
192
+            Git repos can be trumped at the commit and patch levels.
193
+            Then normal SemVer rules take effect for properly tagged releases.
194
+          </li>
195
+            
196
+          <li id="r2.3"><a href="#h2"><strong>&uarr;</strong></a> <a href="#r2.3">2.3</a>
197
+            <strong>Report Trumps and Dupes.</strong>
198
+            If you trump a torrent or notice a duplicate torrent, please use the report link [RP] to notify staff to remove it.
199
+            If you are uploading a superior version, e.g., without watermarks, report the older torrent and include a link to your new torrent.
200
+            Your torrent may be deleted as a dupe if the older torrent is not reported.
201
+          </li>
202
+            
203
+          <li id="r2.4"><a href="#h2"><strong>&uarr;</strong></a> <a href="#r2.4">2.4</a>
204
+            <strong>Two Weeks Unseeded.</strong>
205
+            If you have the original torrent files for the inactive torrent, reseed those original files instead of uploading a new torrent.
206
+            Uploading a replacement torrent should be done only when the original files are unavailable.
207
+          </li>
208
+                        
209
+          <li id="r2.5"><a href="#h2"><strong>&uarr;</strong></a> <a href="#r2.5">2.5</a>
210
+            <strong>Watermarks.</strong>
211
+            Data without watermarks trumps watermarked data.
235 212
           </ul>
236 213
         </div>
237 214
 
238
-    <h4 id="h2"><a href="#h2k"><strong>&uarr;</strong></a> <a href="#h2">2.</a> Site Rules</h4>
239
-      <h5 id="h2.1"><a href="#h2.1k"><strong>&uarr;</strong></a> <a href="#h2.1">2.1.</a> Upload Form Walkthrough</h5>
215
+      <h5 id="h3"><a href="#h3k"><strong>&uarr;</strong></a> <a href="#h3">3</a> Upload Form Walkthrough</h5>
240 216
         <div class="box pad" style="padding: 10px 10px 10px 20px;">
241 217
           <ul>
242
-            <li id="r2.1.1"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.1">2.1.1.</a>
218
+            <li id="r3.1"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.1">3.1</a>
243 219
               <strong>Torrent File.</strong>
244
-              Add the announce URL to the tracker list (the only item) and click the checkbox marked private.
220
+              Add the announce URL as the only item on the tracker list and click the checkbox marked private.
221
+              Please don't share <code>.torrent</code> files because they have your passkey embedded in them.
222
+              This passkey lets the tracker know who's uploading and downloading, and leaking it will nuke your ratio.
223
+              <br /><br />
245 224
 </li>
246 225
 
247
-            <li id="r2.1.2"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.2">2.1.2.</a>
226
+<li id="r3.2"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.2">3.2</a>
248 227
               <strong>Type.</strong>
249 228
               The categories loosely follow the central dogma.
250 229
               It depends on what alphabet the sequence uses, e.g., ACGT vs. ACGU.
251 230
               All medical imaging data goes in the Imaging category.
252
-              Plasmids and things that don't quite fit go in the Other category.
253
-              Only uploads not belonging in other categories are allowed there.
254
-            </li>
231
+              All extra documentation, custom scripts, etc., goes in Documents.
232
+              Plasmids and things that don't quite fit go in Other.
233
+              <br /><br />
234
+</li>
255 235
 
256
-            <li id="r2.1.3"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.3">2.1.3.</a>
236
+<li id="r3.3"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.3">3.3</a>
257 237
               <strong>Accession Number.</strong>
258
-              For nucleotide, amino acid sequences or whatever number the source repository uses.
238
+              Please add accession numbers when the data source issued them.
239
+              The number can be any format but it must correspond to the actual torrent data.
240
+              Don't add accession numbers just because the metadata matches.
259 241
               RefSeq and UniProt integration is in development.
260
-              You're encouraged to add an accession number whenever the <?= SITE_NAME ?> and repo data hashes match.
261
-            </li>
242
+              <br /><br />
243
+</li>
262 244
 
263
-            <li id="r2.1.4"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.4">2.1.4.</a>
245
+<li id="r3.4"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.4">3.4</a>
264 246
               <strong>Torrent Title.</strong>
265 247
               A short description of the torrent contents.
266
-              It doesn't need to match the folders but it should tell you what the data <em>is</em> at a glance.
267
-            </li>
248
+              It doesn't need to match the folders but it should tell you what the data is at a glance.
249
+              Please avoid adding other metadata such as Strain, Platform, etc., with a dedicated field.
250
+              <br /><br />
251
+</li>
268 252
 
269
-            <li id="r2.1.5"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.5">2.1.5.</a>
253
+<li id="r3.5"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.5">3.5</a>
270 254
               <strong>Organism.</strong>
271
-              The subject of study's binomial name.
272
-              Multiple organisms and FASTA header parser are in development.
273
-            </li>
255
+              The relevant organism's binomial name and optional subspecies.
256
+              Please use <em>Genus species subspecies</em> and no terms such as var. and subsp.
257
+              Multiple organisms and a FASTA/GenBank parser are both in development.
258
+              <br /><br />
259
+</li>
274 260
 
275
-            <li id="r2.1.6"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.6">2.1.6.</a>
261
+<li id="r3.6"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.6">3.6</a>
276 262
               <strong>Strain/Variety.</strong>
277 263
               The strain's name if known.
278
-            </li>
264
+              This should correspond to a specific cell line or breed.
265
+              Otherwise, please omit it.
266
+              <br /><br />
267
+</li>
279 268
 
280
-            <li id="r2.1.7"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.7">2.1.7.</a>
269
+<li id="r3.7"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.7">3.7</a>
281 270
               <strong>Authors(s).</strong>
282
-              The upload form supports multiple authors per torrent.
283
-              Please limit yourself to the top four authors on the paper for the release.
284
-              Do an author search before uploading to get their names right.
271
+              The Author field should contain only the author name.
272
+              The upload form supports multiple authors.
273
+              Do a search before uploading to get their names right.
274
+              Consistent author naming makes browsing easier because it groups torrents on a common page.
285 275
               ORCiD integration is in development.
286
-            </li>
276
+              <br /><br />
277
+</li>
287 278
 
288
-            <li id="r2.1.8"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.8">2.1.8.</a>
279
+<li id="r3.8"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.8">3.8</a>
289 280
               <strong>Department/Lab.</strong>
290 281
               The lab that did the experiments or the last author's home lab.
291 282
               Please use "Unaffiliated" for anonymous or unknown labs.
292
-            </li>
283
+              <br /><br />
284
+</li>
293 285
 
294
-            <li id="r2.1.9"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.9">2.1.9.</a>
286
+<li id="r3.9"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.9">3.9</a>
295 287
               <strong>Location.</strong>
296
-              The lab's physical location as City, (State || Country) Postal Code.
297
-              For example, Berkeley, CA 94720 or Berlin, Germany 10117.
298
-              Please use "Unknown" if needed.
299
-            </li>
288
+              The lab's physical location in one of the below formats.
289
+              <ul>
290
+                <li>{City}, {State} {Postal Code}</li>
291
+                <li>{Postal Code} {City}, {Country}</li>
292
+              </ul>
293
+              For example, Berkeley, CA 94720 or 10117 Berlin, Germany.
294
+              It's okay to use the American style if the foreign address uses the same format.
295
+              Please use "Unknown" for anonymous or unknown labs.
296
+              <br /><br />
297
+</li>
300 298
 
301
-            <li id="r2.1.10"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.10">2.1.10.</a>
299
+<li id="r3.10"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.10">3.10</a>
302 300
               <strong>Year.</strong>
303 301
               The year the data was first published.
304 302
               The publication that announced the data.
305
-            </li>
303
+              <br /><br />
304
+</li>
306 305
 
307
-            <li id="r2.1.11"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.11">2.1.11.</a>
306
+<li id="r3.11"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.11">3.11</a>
308 307
               <strong>Platform.</strong>
309 308
               The class of technology the data comes from.
310 309
               What sequencing or imaging technique is it the output of?
311 310
               <a href="forums.php?action=viewforum&forumid=<?= SUGGESTIONS_FORUM_ID ?>">Please post in the suggestions forum</a>
312 311
               if you'd like to request a new platform.
313 312
               Note that the platforms change for the Imaging category.
314
-            </li>
313
+              <br /><br />
314
+</li>
315 315
 
316
-            <li id="r2.1.12"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.12">2.1.12.</a>
316
+<li id="r3.12"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.12">3.12</a>
317 317
               <strong>Format.</strong>
318
-              The file format of the data itself.
318
+              The file format of the data.
319 319
               What programs do you need to work with the data?
320 320
               <a href="forums.php?action=viewforum&forumid=<?= SUGGESTIONS_FORUM_ID ?>">Please post in the suggestions forum</a>
321 321
               if you'd like to request a new format.
322 322
               Note that the formats change for the Imaging category.
323
-            </li>
323
+              A file extension parser is in development.
324
+              <br /><br />
325
+</li>
324 326
 
325
-            <li id="r2.1.13"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.13">2.1.13.</a>
327
+<li id="r3.13"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.13">3.13</a>
326 328
               <strong>Assembly Level.</strong>
327
-              The resolution of the data itself.
329
+              The resolution of the data.
328 330
               How much information about the organism does it represent?
329
-              Please use the Other selection if you'd like to enter a resolution.
330
-              20 character limit.
331
-            </li>
331
+              The options correspond in higher conceptual language to:
332
+              a single piece of information, structural information, especially deep or broad information, and an exhaustive source.
333
+              Please use the Other option if you'd like to enter a resolution such as "420 subjects."
334
+              <br /><br />
335
+</li>
332 336
 
333
-            <li id="r2.1.14"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.14">2.1.14.</a>
337
+<li id="r3.14"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.14">3.14</a>
334 338
               <strong>License.</strong>
335 339
               <?= SITE_NAME ?> only allows permissive licenses.
336
-              If your data is original, please consider licensing it under the available options.
337
-              The "Unknown" option is for compatibility with existing web releases.
338
-            </li>
340
+              If your data is original, please consider licensing it under one of the available options.
341
+              The "Unknown" option is for compatibility with existing releases.
342
+              <br /><br />
343
+</li>
339 344
 
340
-            <li id="r2.1.15"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.15">2.1.15.</a>
345
+<li id="r3.15"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.15">3.15</a>
341 346
               <strong>Tags.</strong>
342 347
               Please select at least five appropriate tags.
343
-              Don't use irrelevant tags, and consider making new tags a last resort.
348
+              Don't use irrelevant tags, and consider making new tags as a last resort.
344 349
               <a href="forums.php?action=viewforum&forumid=<?= SUGGESTIONS_FORUM_ID ?>">Please post in the suggestions forum</a>
345 350
               if you'd like to request a new official tag.
346
-            </li>
351
+              <br /><br />
352
+</li>
347 353
 
348
-            <li id="r2.1.16"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.16">2.1.16.</a>
354
+<li id="r3.16"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.16">3.16</a>
349 355
               <strong>Picture.</strong>
350 356
               Please upload a meaningful picture, especially if you plan to add the torrent to a collection.
351
-              A photo of the specimen sequenced or a representative photo of the organism; a sample from an imaging dataset;
357
+              A photo of the sequence sample or a representative photo of the organism; an example (preferably not a thumbnail collection) from an imaging dataset;
352 358
               a screenshot of a useful table from the publication; or another similarly informative picture.
353
-            </li>
359
+              <br /><br />
360
+</li>
354 361
 
355
-            <li id="r2.1.17"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.17">2.1.17.</a>
362
+<li id="r3.17"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.17">3.17</a>
356 363
               <strong>Publications.</strong>
357 364
               DOI numbers should be well-formed, one per line.
358
-              The upload system currently discards malformed DOI numbers instead of extracting them from arbitrary strings.
365
+              The system currently discards malformed DOI numbers instead of extracting them from arbitrary strings.
366
+              An auto-extract feature is in development.
359 367
               If your research is a URI, please use the Torrent Group Description field.
360
-              10 publication limit.
361
-            </li>
368
+              <br /><br />
369
+</li>
362 370
 
363
-            <li id="r2.1.18"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.18">2.1.18.</a>
371
+<li id="r3.18"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.18">3.18</a>
364 372
               <strong>Torrent Group Description.</strong>
365 373
               General info about the object of study's function or significance.
366
-              Please limit the contents of this field to the object of study.
367
-            </li>
374
+              This is the main body text on a torrent's page.
375
+              Please limit the contents of this field to concise and interesting knowledge.
376
+              <br /><br />
377
+</li>
368 378
 
369
-            <li id="r2.1.19"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.19">2.1.19.</a>
379
+<li id="r3.19"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.19">3.19</a>
370 380
               <strong>Torrent Description.</strong>
371 381
               Specific info about the protocols and equipment relevant to <em>this</em> data.
372
-              Please discuss the technical details of getting the data in this torrent-specific field.
373
-            </li>
382
+              This text is hidden by default.
383
+              It displays when you click the Torrent Title next to [ DL | ... | PL ].
384
+              Please discuss materials and methods here.
385
+              <br /><br />
386
+</li>
374 387
 
375
-            <li id="r2.1.20"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.20">2.1.20.</a>
388
+<li id="r3.20"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.20">3.20</a>
376 389
               <strong>Aligned Sequence.</strong>
377
-              Does the data come with any metadata of an analytical nature, such as alignment data?
378
-              If so, does the torrent folder contain the scripts used to generate the metadata?
379
-            </li>
390
+              Does the data come with any metadata of an analytical nature, such as alignment data (mandatory)?
391
+              If so, does the torrent folder contain the scripts used to generate the metadata (optional)?
392
+              <br /><br />
393
+</li>
380 394
 
381
-            <li id="r2.1.21"><a href="#h2.1"><strong>&uarr;</strong></a> <a href="#r2.1.21">2.1.21.</a>
395
+<li id="r3.21"><a href="#h3"><strong>&uarr;</strong></a> <a href="#r3.21">3.21</a>
382 396
               <strong>Upload Anonymously.</strong>
383 397
               You'll still get upload credit even if you hide your username from the torrent details.
384 398
               I believe it's still visible to sysops.
385 399
             </li>
386 400
           </ul>
387
-        </div>
388 401
 
389
-      <h5 id="h2.2"><a href="#h2.2k"><strong>&uarr;</strong></a> <a href="#h2.2">2.2.</a> Duplicates and Trumping</h5>
390
-        <div class="box pad" style="padding: 10px 10px 10px 20px;">
391
-          <ul>
392
-            <li id="r2.2.1"><a href="#h2.2"><strong>&uarr;</strong></a> <a href="#r2.2.1">2.2.1.</a>
393
-            <strong>Upload an allowed format if it doesn't already exist on the site.</strong>
394
-            If there is no existing torrent of the title in the format you've chosen, you can upload it, so long as it is an allowed format.
395
-          </li>
396
-            
397
-          <li id="r2.2.2"><a href="#h2.2"><strong>&uarr;</strong></a> <a href="#r2.2.2">2.2.2.</a>
398
-            <strong>Torrents that have the same platform, formats, assembly level, etc., are duplicates.</strong>
399
-            If a torrent is already present on the site in the format you wanted to upload, you are not allowed to upload it.
400
-            Different editions and sources do not count as dupes.
401
-          </li>
402
-            
403
-            <li id="r2.2.3"><a href="#h2.2"><strong>&uarr;</strong></a> <a href="#r2.2.3">2.2.3.</a>
404
-            <strong>Report all trumped and duplicated torrents.</strong>
405
-            If you trump a torrent or notice a duplicate torrent, please use the report link [RP] to notify staff for removal of the old or duplicate torrent.
406
-            If you are uploading a superior version of the current one in the same format on the site, report the older torrent and include a link to your new torrent.
407
-            Your torrent may be deleted as a dupe if the older torrent is not reported because the most recent upload is considered a duplicate.
408
-          </li>
409
-            
410
-            <li id="r2.2.4"><a href="#h2.2"><strong>&uarr;</strong></a> <a href="#r2.2.4">2.2.4.</a>
411
-            <strong>Torrents that have been inactive (unseeded) for two weeks may be trumped by the identical torrent (reuploaded).</strong>
412
-            If you have the original torrent files for the inactive torrent, it is preferable to reseed those original files instead of uploading a new torrent.
413
-            Uploading a replacement torrent should be done only when the files from the original torrent cannot be recovered or are unavailable.
414
-          </li>
415
-                        
416
-            <li id="r2.2.5"><a href="#2.2"><strong>&uarr;</strong></a> <a href="#r2.2.5">2.2.5.</a>
417
-            <strong>Uploads without watermarks trump those with them.</strong>
418
-          </ul>
419
-        </div>
420 402
   </div>
421 403
 <!-- END Other Sections -->
422 404
 <? include('jump.php'); ?>

Loading…
Cancel
Save