Differences

This shows you the differences between two versions of the page.

--- eln-guide-basic-data-dryad [2026/04/06 19:51] – csdunham
+++ eln-guide-basic-data-dryad [2026/04/06 21:51] (current) – [Step 5: Lock & Export] saejinoh
@@ Line 12: / Line 12: @@
 ===== Step 1: API token =====
-In order to submit data to Data Dryad, you must first obtain an API token from your Data Dryad account page. Upon activating the API account, you will see the ability to generate an API token at the bottom of the page, as shown in Fig 2. Upon generating a token, it will remain active/usable for 10 years. After 10 hours, the user will need to get a new token.
+In order to submit data to Data Dryad, you must first obtain an API token from your Data Dryad account page. Upon activating the API account, you will see the ability to generate an API token at the bottom of the page, as shown in Fig 2. Upon generating a token, it will remain active/usable for 10 hours. After 10 hours, the user will need to get a new token.
 \\
 \\
@@ Line 65: / Line 65: @@
 ----
-===== Step 4: README File =====
+===== Step 4: README File Editor =====
-TBD...
+All Data Dryad submissions require a README file. Details of the README file can, and should, be viewed at the Data Dryad website. Data Dryad README files are written in the Markdown language, and in order to help you write your READMEs for Dryad, we've produced a rich text-to-Markdown editor (Fig 7) that looks and works exactly like the ELN's text editor you're familiar with, except it outputs Markdown content! It also has had some features removed that are not Markdown-compatible.
+\\
+\\
+{{:dryad-readme-editor.png?600|}}
+\\
+//Fig 7. Rich text-to-Markdown editor. The editor content is always loaded with the default Markdown template provided by Data Dryad to get you started with your README file.//
+\\
+\\
+The Markdown editor here has an autosave feature, and any content entered into the editor is automatically saved every 2 seconds. Successful saves display a timestamp for the last time they were saved. The Markdown editor supports standard Markdown features, such as: header levels, ordered and unordered lists, tables, and basic text formatting. These README files are not intended to hold image-based information, so image and video uploads are disabled.
+\\
+\\
+**An important note:** Data Dryad has an expectation, really a requirement, that the README file contain at least a bit of information for every file that you've uploaded as part of your dataset. This information is often expected in the form of //**'[file_name]': description of file contents and how to use it correctly**//. However, Data Dryad's API does not communicate information about README file deficiencies like this, nor does it allow editing of an uploaded README over the API (or, at least, those methods aren't exposed; we will revise this section if that changes). A consequence of this is that we are not able to enforce some of Dryad's README conventions in the ELN's README editor, and so, you will need to reconcile discrepancies via the Data Dryad website (reminder: you can always access the Data Dryad website for your dataset by clicking the 'Link to Dryad' link on the dataset card).
 ----
 ===== Step 5: Lock & Export =====
-TBD...
+Once you've finished sending files to Dryad, editing your Dataset's metadata, and formatting your README file, the time will come to close up shop for this Dataset and lock and export your README file to Data Dryad. This is where the Lock & Export feature is used. Clicking this button reveals a form field for your Dryad API token. Upon providing the token and clicking Confirm Export, another dialog box will pop up to remind you of the consequences of this action: the editor will become locked, editing the Dataset metadata in the Launchpad utility will be disabled, and files will no longer be available to upload to Dryad from this dataset. In short, it deactivates all mechanisms to send data from the Launchpad Dataset to Dryad. Please make sure this is the action you want and are ready for!
 ====== Launchpad Caveats ======