Skip to content

Commit 9f48f22

Browse files
Subsequent publishing (#273)
## What Did You Change? Added information on subsequent publishing and jump links to the versioning guide. ## Do You Want Support (syntax, design, etc)? <!-- After you open this PR, you can preview your changes. A comment will appear with a link to the server. --> ## Any Reference Material Worth Sharing? --------- Co-authored-by: Wesley B <62723358+wesleyboar@users.noreply.github.com>
1 parent a5557b8 commit 9f48f22

1 file changed

Lines changed: 39 additions & 16 deletions

File tree

user-guide/curating/guides.md

Lines changed: 39 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,9 @@ To begin curation and add an experiment, click on the **Curation Directory** and
3030

3131
Go through the overview and fill out additional required fields in the **Edit Project** window, click **Update Project**, then click **Add Experiments**.
3232

33-
Adding an experiment involves filling out high level information about the files you will be publishing. Each experiment will receive its own DOI. Add multiple experiments if any of this information changes or you want multiple DOIs. Do not add another experiment if you are testing multiple models and this information stays the same. Instead, you can add multiple models to one experiment.
33+
Adding an experiment involves filling out high level information about the files you will be publishing. Each experiment is a dataset that will receive its own DOI and citation. Add multiple experiments if any of its metadata changes or you want multiple DOIs. Do not add another experiment if you are testing multiple models and the metadata stays the same. Instead, you can add multiple models to one experiment.
34+
35+
Experimental datasets can be published incrementally to accommodate projects that generate more than one dataset over time.
3436

3537
![](./imgs/guide-experimental-2b.png)
3638

@@ -44,7 +46,7 @@ You can edit an experiment from the inventory.
4446

4547
### 3. Add Categories { #step3 }
4648

47-
Click **Add Categories** to begin.
49+
Select **Add Categories** to begin.
4850

4951
![](./imgs/guide-experimental-3.png)
5052

@@ -76,7 +78,7 @@ After filling out the fields, click **+ Add Category** and it will appear below
7678

7779
### 4. Relate Data { #step4 }
7880

79-
Click **Relate Data** to begin.
81+
Select **Relate Data** to begin.
8082

8183
![](./imgs/guide-experimental-4.png)
8284

@@ -122,14 +124,20 @@ Look through the Publication Preview early and often to catch any mistakes. If y
122124

123125
### 8. Prepare to Publish { #step8 }
124126

125-
When you are satisfied with how your work is curated and wish to publish it, select Prepare to Publish in the Publication Preview.
127+
When you are satisfied with how your work is curated and wish to publish it, select **Prepare to Publish / Version / Amend** in the Publication Preview.
126128

127129
![](./imgs/guide-experimental-8.png)
128130

131+
If this is your first time publishing a dataset in this project, select Publish to continue.
132+
133+
If you have previously published a dataset, the options to amend metadata, version, or publish additional datasets are available. The [Versioning Guide](#versioning) provides information on how to update, remove or add files to your individual datasets.
134+
135+
The process for publishing an additional dataset is identical to publishing one for the first time.
136+
129137
There are 6 stages in the publication process: <br>
130138
Selection, Proofread Project, Proofread Experiment, Proofread Categories, Order Authors, and Licenses
131139

132-
In **Selection**, select which experiment you want to publish. You can only publish one at a time.
140+
In **Selection**, select which experiments you want to publish.
133141

134142
In **Proofread Project**, **Experiment**, & **Categories**, take time to proofread all the descriptions and metadata you have entered. You cannot make changes after publishing.
135143

@@ -171,7 +179,9 @@ To begin curation and add a simulation, click on the **Curation Directory** and
171179

172180
Go through the overview and fill out additional required fields in the **Edit Project** window, click **Update Project,** then click **Add Simulations**.
173181

174-
Adding a simulation involves filling out high level information about the files you will be publishing. Each simulation will receive its own DOI. Add multiple simulations if any of this information changes or you want multiple DOIs. Do not add another simulation if you are testing multiple models and this information stays the same. Instead, you can add multiple models to one simulation.
182+
Adding a simulation involves filling out high level metadata about the files you will be publishing. Each simulation is a dataset that will receive its own DOI and citation. Add multiple simulations if any of its metadata changes or you want multiple DOIs. Do not add another simulation if you are testing multiple models and the metadata stays the same. Instead, you can add multiple models to one experiment.
183+
184+
Simulation datasets can be published incrementally over time to accommodate projects that generate more than one dataset over time.
175185

176186
![](./imgs/guide-simulation-2b.png)
177187

@@ -217,8 +227,7 @@ After filling out the fields, click **+ Add Category** and it will appear below
217227

218228
### 4. Relate Data { #simulation-step4 }
219229

220-
221-
Click **Relate Data** to begin.
230+
Select **Relate Data** to begin.
222231

223232
Relating Data allows you to relate categories to each other and to an simulation, which determines the layout and order of categories in your publication. You can reorder the categories if needed.
224233

@@ -264,9 +273,13 @@ Look through the Publication Preview early and often to catch any mistakes. If y
264273

265274
![](./imgs/guide-simulation-8a.png)
266275

267-
When you are satisfied with how your work is curated and wish to publish it, select Prepare to Publish in the Publication Preview.
276+
When you are satisfied with how your work is curated and wish to publish it, select **Prepare to Publish / Version / Amend** in the Publication Preview.
277+
278+
If this is your first time publishing a dataset in this project, select Publish to continue.
268279

269-
![](./imgs/guide-simulation-8b.png)
280+
If you have previously published a dataset, the options to amend metadata, version, or publish additional datasets are available. The [Versioning Guide](#versioning) provides information on how to update, remove or add files to your individual datasets.
281+
282+
The process for publishing an additional dataset is identical to publishing one for the first time.
270283

271284
There are 6 stages in the publication process: <br>
272285
Selection, Proofread Project, Proofread Simulation, Proofread Categories, Order Authors, and Licenses
@@ -277,6 +290,8 @@ In **Proofread Project**, **Simulation**, & **Categories**, take time to proofre
277290

278291
In **Order Authors**, order the authors of the simulation and preview how your citation will appear.
279292

293+
![a screenshot of license options to choose when publishing](./imgs/guide-simulation-8b.png)
294+
280295
In **Licenses**, select one or more licenses that best fit your data.
281296

282297
Finally, click **Request DOI & Publish** and agree to the agreement to publish your work.
@@ -321,7 +336,9 @@ A mission is a group of data collections that are associated with a common goal
321336

322337
Adding a mission involves filling out high-level information (e.g. title, date, geolocation and description) about the files you will be publishing.
323338

324-
Each mission will receive a unique DOI. Add multiple missions if any of this high-level information changes or you want multiple DOIs. Do not add another mission if you are surveying the same location with different instruments and this information stays the same. Instead, you can add multiple collections to one mission.
339+
Each mission will receive a unique DOI and citation. Add multiple missions if any of this high-level metadata changes or you want multiple DOIs. Do not add another mission if you are surveying the same location with different instruments and this information stays the same. Instead, you can add multiple collections to one mission.
340+
341+
Missions and Document Datasets can be published incrementally to accommodate projects that generate one or more document collections, and one or more datasets over time.
325342

326343
Fill out the required and optional fields using the advice given to create concise and understandable descriptions. You can order the authors later when it is time to publish.
327344

@@ -331,7 +348,7 @@ You can edit a mission from the mission inventory.
331348

332349
### 3. Add Collections { #fieldresearch-step3 }
333350

334-
Click **Add Collections** to begin.
351+
Select **Add Collections** to begin.
335352

336353
Collections group files together based on a shared purpose in a mission. There are three different collection types in field research data model:
337354

@@ -351,7 +368,7 @@ Social Sciences Collection
351368

352369
### 4. Relate Data { #fieldresearch-step4 }
353370

354-
Click **Relate Data** to begin.
371+
Select **Relate Data** to begin.
355372

356373
Relating Data allows you to relate collections to missions, which determines the organization of your dataset. You can also establish the order of your collections.
357374

@@ -407,7 +424,13 @@ Look through the Publication Preview early and often to make changes or catch mi
407424

408425
### 8. Prepare to Publish { #fieldresearch-step8 }
409426

410-
When you are satisfied with how your work is curated and wish to publish it, select Prepare to Publish in the Publication Preview.
427+
When you are satisfied with how your work is curated and wish to publish it, select **Prepare to Publish / Version / Amend** in the Publication Preview.
428+
429+
If this is your first time publishing a dataset in this project, select Publish to continue.
430+
431+
If you have previously published a dataset, the options to amend metadata, version, or publish additional datasets are available. The [Versioning Guide](#versioning) provides information on how to update, remove or add files to your individual datasets.
432+
433+
The process for publishing an additional dataset is identical to publishing one for the first time.
411434

412435
There are 6 stages in the publication process:
413436
Selection, Proofread Project, Proofread Mission, Proofread Collections, Order Authors, and Licenses
@@ -418,14 +441,14 @@ In **Proofread Project**, **Missions**, & **Collections**, take time to read all
418441

419442
In **Order Authors**, order the authors of the mission and preview how your citation will appear.
420443

444+
![a screenshot of license options to choose when publishing](./imgs/guide-fieldresearch-8.jpg)
445+
421446
In **Licenses**, select one or more licenses that best fit your data.
422447

423448
Please see the [Data Publication Guidelines](/user-guide/curating/bestpractices) for more information.
424449

425450
Finally, click **Request DOI & Publish** and agree to the agreement to publish your work.
426451

427-
![](./imgs/guide-fieldresearch-8.jpg)
428-
429452
---
430453

431454
## Research Software

0 commit comments

Comments
 (0)