Versions Compared

Key

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

Status
colourRed
titleSTATUS: IN DEVELOPMENT

...

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

  • Adhere to the Style guide

  • Ensure the content you provide respects copyright by following the Copyright guidelines (TODO).

Suggested approach for writing a page

...

  • You are expected to review pages

    • The Editorial board will communicate 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:

    Preliminary check

    :

    Perform a preliminary check to ensure the draft meets basic requirements. This includes checking for references, visuals, adherence to the style guide, and basic formatting.

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

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

...

  • 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 right

    • Manage inactive accounts: Periodically review member activity and disable accounts of inactive members to maintain an active and engaged contributor base.

  • Prioritizing Prioritising and planning:

    • Page prioritizationprioritisation: Decide which pages 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 meet the quality standards.

    • Style guide 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.

...