Table of Contents

Content review

Who is this guide for

What this guide teaches

Things to know beforehand

Datasets with open issues stay unpublished

The review workflow is based on the fact that datasets or library records will be published as long as it does not have any open Issues or once all its issues have been closed. When a dataset is created, a default issue will be raised automatically, marking the dataset as private.

Instructions in default issue

Be sure to read the instructions provided in the issue raised automatically on dataset creation.

Do not forget to specify your email in your profile

Every time an issue gets created, closed, deleted or re-opened, both administrators of the organization and the creator of the dataset will be notified via email.

Dataset creators cannot close or delete issues

In order to avoid the situation where a user creates a dataset and marks it for publication right after (by closing the default issue ), dataset creators are not allowed to close or delete Issues. This makes it mandatory that each dataset is reviewed within the workflow described below before being published.

Workflow description

Default Issue created along with the dataset

Upon dataset creation, a default Issue will be created in order to signalize the start of the review workflow. This default issue will as well contain detailed instructions about what needs to be done, both by admin users reviewing the dataset and its owner.

In order to mark this dataset as reviewed and publish it, all open issues within the dataset need to be closed.

Reviewing datasets

Being notified per email, the admin users of the organization the dataset belongs to will be asked to go to a particular link and review the dataset.

Reviewing dataset's metadata

The first thing to review will be the metadata of the dataset;

- Paste instructions here

In case any of the metadata fields contain incorrect information or is not filled as expected, the reviewer should open a new Issue and set title and description accordingly. Once the issue is opened, both the creator of the dataset and the organization's admins will be notified.

Reviewing dataset's resources content

After reviewing the metadata it is turn to review the content of the dataset:

- Paste instructions here

Using the discussion feature

In order to take the decision of closing a pending Issue, admin users reviewing the dataset can discuss about the reasons, implication and solution for that particular Issue. For that, in every Issue page, there is the possibility to leave comments.

Marking the dataset for publication

Once the last open Issue has been closed, the dataset will be automatically made public and thus will be available for non-registered user to see.

Reviewing published dataset

If an admin of an organization detects a mistake in one of the already published datasets, an Issue can be raised in order to unpublish the dataset (marking it as private) and start the review process again for it.