Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourRed
titleSTATUS: IN DEVELOPMENT

...

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 siteindividual contributor possesses sole ownership of the site’s content, 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.

...

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 provide feedback on pages written by other members of the Writing group during the two week feedback period.

  • To get a clear understanding of what is expected in each section of a FAIR Metroline page, study the template.

  • Please adhere to the Style guide.

  • Please follow the Copyright guidelines to ensure the content you provide respects copyright by following the Copyright guidelines (TODO).

  • Please make sure you comply to the Editors checklist (TODO).

Suggested approach for writing a page:

  1. 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.

    1. Add your text by mentioning your name between brackets, followed by the text. For example: [Sander] This is my text.

  2. 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.

  3. When you feel the page is ready, notify the Writing group to make the page available for internal review.

    1. The Writing Group reviewers can either directly edit the page or add comments with suggested improvements.

  4. When development of the page is done, 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

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 3 weeks

    • The Editorial board will communicate when and which pages are available for review after the monthly board meeting.

  • You can add suggestions by adding comments to a page. 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 you to further clarify/discuss a suggestion. Note that even though all suggestions will be taken seriously, not all will necessarily be adopted.

  • After the comments have been addressed, the Editorial Board decides whether the page is ready to be released/adopted

The To reduce expenses, the Editorial board regularly checks whether Confluence accounts are actively used and disables the inactive ones to reduces expenses. Send . To reactivate a disabled account, please send an email to fairservicedesk@health-ri.nl to reactivate you account.

Editorial board

The Editorial board is responsible for the FAIR Metroline as a product. As a board member you:

  • Create and improve the processes around the FAIR Metroline

  • Keep track of the members of the Writing group and Reviewing group

    • 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

    • Disable accounts of inactive members

  • Decide which pages are developedprioritised, aligned with the plateau planning

  • Keep track of the development stages of the pages and update the page’s status accordingly

  • Ensure that the Writing group provides feedback in the development stage in a timely matter

  • Ensure that the Reviewing group and others are notified when pages are ready for review

    • Via email, websites and/or blog-posts, e.g. on the Health-RI website

    • Information includes a link to the How to contribute page

  • Ensure pages meet the quality standards:

    • Check whether pages follow the Style guide

    • Occasionally check the pages for dead links

...

Contributors, if possible with their ORCID, are shown at the bottom of most pages. All contributors are also displayed on the contributors page (TODO).

  • Status
    colourRed
    titleSTATUS: IN DEVELOPMENT
    : the page is or will soon be developed the Writing group. See the Writing Process section for suggestions on how to write a page.

    • If contributing in this stage, you’re a writer. This means you are part of the Writers in the contributors page. Writing Group.

  • Status
    colourYellow
    titleSTATUS: READY FOR REVIEW
    : 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.

    • If contributing in this stage, you’re a reviewer. This means you are part of the Reviewers in the contributors page. Reviewers Group.

  • Status
    colourGreen
    titleSTATUS: Released
    : The page has been formally released by the Editorial board. See Editorial Process for details.

...