diff --git a/docs/courses/09_peer_review.md b/docs/courses/09_peer_review.md index 3c22d03d..51edcc5d 100644 --- a/docs/courses/09_peer_review.md +++ b/docs/courses/09_peer_review.md @@ -105,6 +105,9 @@ of knowledge and fostering innovation in the field of energy. ## How do you review open data? +:oep-icon-code: [Tutorial on Open Peer Review] (link to tutorial once its published) +This tutorial gives a detailed step by step description of the Open Peer Review Process on the OEP. + Adapting an open peer review process to open data and its metadata involves a structured approach to ensure the quality and reliability of the information. diff --git a/docs/tutorials/99_other/images/Generale 2 at 21.42.05.png b/docs/tutorials/99_other/images/Generale 2 at 21.42.05.png new file mode 100644 index 00000000..5a15b9ec Binary files /dev/null and b/docs/tutorials/99_other/images/Generale 2 at 21.42.05.png differ diff --git a/docs/tutorials/99_other/images/Meta information at 21.29.35.png b/docs/tutorials/99_other/images/Meta information at 21.29.35.png new file mode 100644 index 00000000..00c04ff3 Binary files /dev/null and b/docs/tutorials/99_other/images/Meta information at 21.29.35.png differ diff --git a/docs/tutorials/99_other/images/Spatiotemporal at 21.51.16.png b/docs/tutorials/99_other/images/Spatiotemporal at 21.51.16.png new file mode 100644 index 00000000..b9f9da22 Binary files /dev/null and b/docs/tutorials/99_other/images/Spatiotemporal at 21.51.16.png differ diff --git a/docs/tutorials/99_other/images/badge_selection.png b/docs/tutorials/99_other/images/badge_selection.png new file mode 100644 index 00000000..ad2cfc8a Binary files /dev/null and b/docs/tutorials/99_other/images/badge_selection.png differ diff --git a/docs/tutorials/99_other/images/blocked_review.png b/docs/tutorials/99_other/images/blocked_review.png new file mode 100644 index 00000000..8d8291bc Binary files /dev/null and b/docs/tutorials/99_other/images/blocked_review.png differ diff --git a/docs/tutorials/99_other/images/embargo.png b/docs/tutorials/99_other/images/embargo.png new file mode 100644 index 00000000..9e83e7ff Binary files /dev/null and b/docs/tutorials/99_other/images/embargo.png differ diff --git a/docs/tutorials/99_other/images/profile_active_reviews.png b/docs/tutorials/99_other/images/profile_active_reviews.png new file mode 100644 index 00000000..231a27e8 Binary files /dev/null and b/docs/tutorials/99_other/images/profile_active_reviews.png differ diff --git a/docs/tutorials/99_other/images/section_general.png b/docs/tutorials/99_other/images/section_general.png new file mode 100644 index 00000000..835510a0 Binary files /dev/null and b/docs/tutorials/99_other/images/section_general.png differ diff --git a/docs/tutorials/99_other/images/section_license.png b/docs/tutorials/99_other/images/section_license.png new file mode 100644 index 00000000..c625982f Binary files /dev/null and b/docs/tutorials/99_other/images/section_license.png differ diff --git a/docs/tutorials/99_other/images/section_sources.png b/docs/tutorials/99_other/images/section_sources.png new file mode 100644 index 00000000..254bda6b Binary files /dev/null and b/docs/tutorials/99_other/images/section_sources.png differ diff --git a/docs/tutorials/99_other/images/section_summary.png b/docs/tutorials/99_other/images/section_summary.png new file mode 100644 index 00000000..e106e418 Binary files /dev/null and b/docs/tutorials/99_other/images/section_summary.png differ diff --git a/docs/tutorials/99_other/images/start_opr.png b/docs/tutorials/99_other/images/start_opr.png new file mode 100644 index 00000000..db2bc3db Binary files /dev/null and b/docs/tutorials/99_other/images/start_opr.png differ diff --git a/docs/tutorials/99_other/review_process.md b/docs/tutorials/99_other/review_process.md new file mode 100644 index 00000000..ba332c4c --- /dev/null +++ b/docs/tutorials/99_other/review_process.md @@ -0,0 +1,80 @@ +# Tutorial - Open Peer Review for OEMetadata + + +OpenEnergy Platform + +## Learnings + +This tutorials will enable you to: + +- Complete every step in the workflow of the Review Process + - Initiation + - Review + - Completion + +## Requirements + +- OEP Account +- a table or dataset uploaded to the [OpenEnergyPlatform](https://openenergyplatform.org/) (OEP) +- metadata for that table or dataset + +## Introduction + +This course will teach you step-by-step how the open peer review process on the OEP works. For a more general overview of the peer review process have a look at the course [09 - Open Peer Review](https://openenergyplatform.github.io/academy/courses/09_peer_review/). + +## Metadata Upload + +In a first step, a contributer [uploads metadata](https://openenergyplatform.org/dataedit/wizard/) to the [OpenEnergyPlatform](https://openenergyplatform.org/) (OEP). Note that a prerequisite to upload metadata is an existing table. We are going to call this person metadata owner from now on. If you are unsure how to create and upload metadata, have a look at [this tutorial](https://openenergyplatform.github.io/academy/tutorials/99_other/beginners_guide/#22-create-metadata). The metadata owner has to make sure that the metadata include a license. They can also apply an embargo period of 6 months or 1 year if they need to. The metadata are automatically uploaded to the [model_draft](https://openenergyplatform.org/dataedit/view/model_draft) schema. + + +## Initiation of the Review Process + +Once the metadata are publicly accessible in the [model_draft](https://openenergyplatform.org/dataedit/view/model_draft) section, anyone (except the metadata owner) can start a review by going to the 'Open Peer Review' View (next to 'Meta information') and clicking on 'Start Open Peer Review' at the end of the page. +![Start](start_opr.png) +The review process is exclusive; meaning that once the review process has started, no one else can initiate another review process for the same metadata. +![Blocked](blocked_review.png) +However, after a review is finished, a new review can be started right away. + +## Review Process + +The reviewer who initiated the process needs to review all regular fields to complete the process. Only empty fields ('None'), contributor fields and technical resource metadata fields don't have to be reviewed. The metadata are devided into sections: General, Spatial & temporal, Source, License and Summary. +In any section tab the reviewer sees on the left hand side a list of all fields that need reviewing. Every selected field, refreshes the right hand side of the window. It shows the field in question, the definition of the field, an example and the corresponding badge. Below that, the review options are given: accept the field, suggest a change or reject it and provide an alternative. Navigating the fields can be done via mouse clicks on the fields of the left hand side or by use of the small arrows in the window on the right hand side. + + +Under `General`, basic informations such as id and title must be given. ![General](images/section_general.png) +The data for spatial and temporal information are given under `Spatial & temporal. TODO Missing Screenshot. +Please provide the information about the used sources under `Sources. ![Sources](images/section_sources.png) +Under `License` the information on the used license must be given. ![License](images/section_license.png) +The `Summary` gives an overview over all fields and shows for which fields a review is missing. ![Summary](images/section_summary.png) + +The reviewer can save their progress with the button in the upper right corner `Save Progress`. The button `quit` leads back to the database without saving changes done after the last save. Once started, a review process cennot be cancelled. + +Users can find all reviews they started on their profile page under `Reviews`. ![Active Reviews](images/profile_active_reviews.png) + +Once the review is completed, it can be submitted with the `Submit` button in the upper right corner. The review is then transmitted from the reviewer back to the contributer. The reviewer can only forward their review to the contributor once they have evaluated all non-empty fields i.e. accepted, suggested or rejected them. (See also: [How do you review open data?](https://openenergyplatform.github.io/academy/courses/09_peer_review/#how-do-you-review-open-data)) + +## Handling Review Suggestions + +If the reviewer has suggestions for certain fields, they are sent to the contributor. In the contributor's profile, under the Peer Review section, the review with the reviewer’s suggestions can be seen. The contributor can then accept or reject the reviewer’s suggestions, proposing alternatives if necessary. After the contributor has reacted to all suggestions, they send it back to the reviewer for verification. This process ends when all fields are mutually accepted. + +## Completion of the Review Process + +When both, the reviewer and the contributer come to an agreement and mutually accept all fields the reviewer can choose a [badge](https://openenergyplatform.github.io/academy/courses/09_peer_review/#how-to-evaluate-and-present-the-review-what-are-badges) and complete the review. ![Badge](images/badge_selection.png) + +## Post-Review Metadata Management + +After the review process is completed, the table & metadata owner can move the metadata from the model_draft to one of the 12 other topics. An embargo period of 6 months or 1 year may be applied. ![Embargo](images/embargo.png) + +## Feedback + +You can provide feedback on this tutorial [here](https://github.com/OpenEnergyPlatform/academy/issues/189). + +## About this tutorial + +:oep-logo-sirop: + +- Author: Vismaya Jochem, Christian Hofmann +- Copyright: Reiner Lemoine Institut +- License: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.en) +- Attribution: Open Energy Academy - OEMetaData Tutorial © [Reiner Lemoine Institut](https://reiner-lemoine-institut.de/) +- Last update: :oep-auto-lastupdate: