| Status | ||||
|---|---|---|---|---|
|
...
While writing and reviewing it is important to keep in mind that the aim of the FAIR Metroline is to provide readers FAIRification guidance in an understandable and applicable way. Each page is designed to be user-friendly, with clear headings, concise language, and practical examples. After reading a page, a user should be able to understand the problem and , take practical steps towards the solution, and apply the FAIR principles to their own research projects. Pages go through the following development phases described below.
: This status indicates that work on this page won’t be started any time soon.Status colour Purple title STATUS: FUTURE WORK
: the page is or This status shows that active work will soon be developed started or is already being done to create the content by the Writing group. See Writing group for more information.Status colour Red title STATUS: IN DEVELOPMENT
: the page is ready to be reviewed At this stage, the content is drafted and checked on quality. Constructive feedback is provided by the Reviewing group, and revisions are made as necessary. See Reviewing group for more information.Status colour Yellow title STATUS: READY FOR REVIEW
: The page This status indicates that the content has been formally released by the Editorial board and is available for public use. See Editorial Process process for details.Status colour Green title STATUS: Released
Decisions regarding whether a page is ready to move to the next development stage are decided Updates to status are made by the Editorial board . See Editorial board for more information.
Since the content of these pages will be dynamic and revisions will be made, statuses will switch over time, even after a step has been adopted. The most recent version will always be the visible one; if an adopted version also exists, the most recent version will contain a link to the adopted version at the top of the page.
...
to ensure that all pages are accurately tracked and maintained throughout their lifecycle. This structured approach allows for a clear workflow and accountability, ensuring that the information provided is both current and reliable.
Content of the FAIR Metroline
The FAIR Metroline is a Health-RI community effort, and decisions are driven by consensus among all contributors (writers, reviewers and editors). No single contributor owns the content of the site, or has the right to dictate what the content should be.
The content of the FAIR Metroline will be periodically updated, based on contributions from the writers and reviewers. The editors Editorial board will ensure that the content represents the majority opinion and that the various perspectives of contributors are taken into account.
Kindly contact fairservicedesk@health-ri.nl if you consider any content to be incorrect.
Writing group
Contributing to the FAIR Metroline is a collaborative and structured process that ensures the content is accurate, comprehensive, and valuable. As part of the Writing group, you have full rights on the FAIR Metroline Confluence pages. Furthermore, you are added to the dedicated Slack channel. You will be mentioned in the Writers' section on the Contributors page.
As a writer, keep in mind the following:
You are expected to co-create pages.
You are expected to review provide feedback on pages written by other members of the Writing group
. See Metroline: Page feedback status (Writing group) (restricted access).Status colour Red title STATUS: IN DEVELOPMENT
To get a clear understanding of what is expected in each section of a FAIR Metroline page, study the template.
Please adhere Adhere to the Style guide.Please follow the Copyright guidelines to ensure
Ensure the content you provide respects copyright (TODO).Please make sure you comply to the Editors checklist by following the Copyright guidelines (TODO).
Suggested approach for writing a page
Brainstorming:
...
Start with a braindump and add everything you can think of. Research your topic and look for existing best-practices in sources such as the FAIR Cookbook and RMDkit. , RMDkit, Turing way and FAIR Sharing. Feel free to add other high quality sources and notify the Editorial board if you have general resources, which should be added to the list.
Drafting: Add your text by mentioning your name between brackets, followed by the text. For example: [Sander] This is my text.
Draft a clear outline that structures the content logically. Include main headings and subheadings to organize the information.
Define the key messages and objectives for the page. What should readers learn or be able to do after reading the page?
Where appropriate, include examples, case studies, diagrams, or other visuals to illustrate points and enhance understanding.Collaboration: Co-write with members from the Writing group. Some of us meet every Friday in Utrecht to co-write, but feel free to plan co-write sessions whenever you deem suitable.
Notification: When you the writers feel the page is ready, notify the Writing group to make the page available for internal review.
The Writing Group reviewers can either directly edit the page or add comments with suggested improvements.
When development of the page is done, Editorial board and they will start the feedback process.
Revisions: Resolve the provided feedback, ensure your page follows the Style guide and notify the Editorial board. The board will verify the page meets the requirements, update the page’s status and inform the Reviewing group.
...
Reviewing group
The reviewing process for contributions is critical to ensure that content is accurate, reliable, and valuable to readers. This process involves multiple steps and participants, ensuring thorough evaluation and quality control.
As part of the Reviewing group, you have comment rights on the FAIR Metroline Confluence pages. You will be mentioned in the Reviewers' section on the Contributors page.
As a reviewer, keep in mind the following:
You are expected to review pages within the time frame of 2 weeks
The Editorial board will communicate if with timeline when and which pages are available for review after the monthly board meeting.
Pages will be available for review for two weeks.
Review process:
Content accuracy: Reviewers thoroughly evaluate the accuracy of the information. They check facts, figures, and references to ensure that all information is correct and up-to-date.
Clarity and readability: Reviewers assess whether the content is clearly written and easy to understand. They check for logical flow, clear explanations, and appropriate use of language.
Relevance and value: Reviewers ensure that the content is relevant to the intended audience and provides valuable insights or guidance. They assess whether the content meets the objectives defined in the outline.
Feedback and suggestions:
Constructive feedback: Reviewers provide detailed feedback, highlighting strengths and identifying areas for improvement. This includes suggestions for enhancing clarity, adding missing information, or correcting inaccuracies.
Specific comments: Reviewers may use tools such as comments or track changes to provide specific notes within the document. This helps the author understand exactly where changes are needed. Please make sure the suggestions are constructive and respectful.
After the review deadline has passed, the original Writing group authors will address the suggestions. This may include contacting Author revisions:
Incorporating feedback: The author or writing group reviews the feedback and makes necessary revisions to the draft. This may involve rewriting sections, adding new information, or adjusting formatting. Contributors may contact you to further clarify/discuss a suggestion. Note that even though all suggestions will be taken seriously, not all will necessarily be adopted.
Second review:
Review of revisions: Reviewers check that all feedback has been adequately addressed and that the revised content meets quality standards. They ensure that all issues identified in the initial review have been resolved.
Final suggestions: If minor adjustments are still needed, reviewers provide final suggestions to the author.
Approval for publication: If the content meets all criteria, the editorial board approves it for publication and updates the status. If further revisions are needed, the content is sent back to the author with specific instructions.
To reduce expenses, the Editorial board regularly checks whether a Confluence account is accounts are actively used and , if not, will disable the accountdisables the inactive ones. To reactivate a disabled account, please send an email to fairservicedesk@health-ri.nl.
Editorial board
The Editorial board is responsible for plays a critical role in overseeing the FAIR Metroline as a product, ensuring it remains a high-quality, reliable, and user-friendly resource. As a member of the Editorial board member you:
...
Create and improve the processes around the Metroline
...
, you have several key responsibilities:
Process creation and improvement:
Develop Processes: Design and establish effective processes for content creation, review, and publication to ensure consistency and quality across all pages.
Continuous Improvement: Regularly assess and refine these processes to enhance efficiency, address any issues, and adapt to new requirements or feedback.
Membership management:
Track members: Maintain an up-to-date record of members in both the Writing group and Reviewing group. This includes monitoring active participation and contributions.
Assign rights: Ensure contributors are in the correct group and have the appropriate rights in Confluence
Writing group members get full access rights
Reviewing group members get comment rights
right
Manage inactive accounts: Periodically review member activity and disable accounts of inactive members to maintain an active and engaged contributor base.
Prioritising and planning:
Page prioritisation: Decide which pages
Ensure page development is in line with the plateau planning
Are allowed to change the status of a page (e.g. from In progress to Ready for review)
- Spread information
need to be developed or updated based on the overall strategic goals and plateau planning. This ensures that the most critical content is prioritized.
Development tracking: Monitor the progress of each page through its development stages. Update the status of pages to reflect their current phase (e.g., FUTURE WORK, IN DEVELOPMENT, READY FOR REVIEW, RELEASED).
Feedback and review coordination:
Ensure feedback: Make sure that the Writing group consistently provides feedback on each other's drafts. This collaborative approach helps improve the quality of content.
Notify reviewers: Informe the Reviewing group and other stakeholders when pages are ready for review
. Use multiple channels to communicate this:
Via email, websites and/or blog-posts, e.g. on the Health-RI website
Information includes a link to the How to contribute page
Quality assurance:
Ensure pages follow meet the quality standards.Style guide
Occasionally check the pages for dead links
Members of the Editorial board have to be part of the Writing group. The board meets once per month.
Keep for now:
Co-create. This includes the feedback from the writing team
Outreach, the page is reviewed by a broad community
Bij de outreach kunnen referen naar de How to contribute. Hier staat ook een (link naar) het formulier (of gewoon een mailtje?)
Formulier voor aanmaken met wat vragen:
Wie ben ik en wat wil ik (Writing, Reviewing, Editorial Board)
Bij Writing → volledige rechten (je krijgt ook emails en wordt deel van slack groep voor communicatie etc.)
Bij Reviewing → comment rechten (krijgen mail voor het reviewen)
Formulier met Make a quick suggestion (zie RDMkit)
Editorial board
Houdt zicht op de Writers en Reviewers
Als een reviewer niet bijdraagt, dan kan zijn/haar account worden gedeactiveerd
Small group, initially part of writing group
Gaat over het product FAIR Metroline
Style guide, de processen die er omheen zitten
Je moet hiervoor dus ook inhoudelijk betrokken zijn
Sturen het proces
welke pagina’s prio hebben
de mails naar buiten en de berichten op webpagina’s
de status van de pagina’s
de rollen van de mensen (inhoud van de groepen) + rechten in confluence
dat het klopt met de plateau planning
Old stuff
Group structure
The FAIR Metroline is being developed by the following groups:
Writing group: people actively co-writing pages
Reviewing group: a broader audience providing feedback on pages
Editorial board: small group responsible for the FAIR Metroline processes
We invite you to collaborate with us as we continue to refine the various FAIR Metroline phases. Contributors will be acknowledged. If you are interested in joining one of the groups, please email fairservicedesk@health-ri.nl.
Acknowledgement of contributors
Contributors, if possible with their ORCID, are shown at the bottom of most pages. All contributors are also displayed on the contributors page (TODO).
: the page is or will soon be developed the Writing group. See the Writing Process section for suggestions on how to write a page.Status colour Red title STATUS: IN DEVELOPMENT If contributing in this stage, you’re a writer. This means you are part of the Writers in the contributors page. Writing Group.
: when the Writing group is satisfied with the page, it is ready to be reviewed by the Reviewing group. See the Reviewing process section for details.Status colour Yellow title STATUS: READY FOR REVIEW If contributing in this stage, you’re a reviewer. This means you are part of the Reviewers in the contributors page. Reviewers Group.
: The page has been formally released by the Editorial board. See Editorial Process for detailsStatus colour Green title STATUS: Released updates: Regularly update the Style guide to reflect current standards and practices. This guide helps maintain uniformity and high quality across all pages.
Adherence to standards: Check that all pages adhere to the Style guide. This includes verifying formatting, language, and structure.
Link maintenance: Review pages for dead links and update or remove them to ensure that all references and resources are accessible and current.
Board membership and meetings:
Writing group membership: All Editorial board members must also be part of the Writing group to stay actively involved in content creation and development.
Monthly Meetings: The Editorial board meets once per month to discuss ongoing projects, review processes, address any issues, and plan future activities. These meetings ensure continuous alignment and effective decision-making.