Migrated from GitLab
Original Author: Dione Mentis (@DioneMentis)
Original Link: https://gitlab.coko.foundation/coko-org/products/ketty/editoria/-/issues/12
1. Context
The purpose of this proposal is to outline the specifications for implementing a Peer Review Module in Ketida. This module will enable users to assign 2 or 3 peer reviewers for books, chapter-wise, and provide an option for reviewers to submit their peer review reports within the platform. The Peer Review Module aims to provide a basic peer review process for books.
2. Objectives
The main objectives of implementing the Peer Review Module are as follows:
- Facilitate the assignment of 2 or 3 peer reviewers for each book and its chapters.
- Streamline the process of submitting and managing peer review reports within the Ketida Books Platform.
3. Functional Requirements
The Peer Review Module should include the following functionalities:
3.1 Reviewer Assignment
- Enable authors or platform administrators to assign 2 or 3 peer reviewers for each book and its chapters. Figure 1 for reference.
- Provide a user-friendly interface to search for and select potential reviewers. The existing selection process is fine.
- Allow reviewers to accept or decline review requests, with appropriate notifications sent to authors/administrators. Figure 5 for reference.
- While the peer review is in progress, other users should not be able to edit the chapter/book, we can use the existing lock feature to control their access.
3.2 Peer Review Report Submission
- Enable reviewers to access assigned books and chapters within the platform.
- Provide a standardized template or form for reviewers to fill out their peer review reports, including key evaluation criteria.
- Allow reviewers to attach supporting documents or files to their reports, if necessary.
- Figure 4 for reference.
3.3 Review Management
- Enable authors and platform administrators to view the status and progress of assigned peer reviews. Figure 6 for reference.
- Provide a communication channel within the platform for authors to clarify reviewer comments or address concerns.
4. Sample User Interface
**Figure 1: **
**Figure 2: **
**Figure 3: **
The Peer Review mode will keep the books in read-only mode, peer reviewers can comment on the document.
**Figure 4: **
Submit Peer Review
**Figure 5: **
Figure 6:
Implementation details
1. Context
The purpose of this proposal is to outline the specifications for implementing a Peer Review Module in Ketida. This module will enable users to assign 2 or 3 peer reviewers for books, chapter-wise, and provide an option for reviewers to submit their peer review reports within the platform. The Peer Review Module aims to provide a basic peer review process for books.
2. Objectives
The main objectives of implementing the Peer Review Module are as follows:
3. Functional Requirements
The Peer Review Module should include the following functionalities:
3.1 Reviewer Assignment
3.2 Peer Review Report Submission
3.3 Review Management
4. Sample User Interface
**Figure 1: **
**Figure 2: **
**Figure 3: **
The Peer Review mode will keep the books in read-only mode, peer reviewers can comment on the document.
**Figure 4: **
Submit Peer Review
**Figure 5: **
Figure 6:
Implementation details