Associate Editor Instructions

Revision as of 00:56, 1 March 2021 by Jennelleh (talk | contribs)

Introduction

  • IMPORTANT: On the Volunteers Page, Track Progress in Real Time of assigning author to pages (pending) and completion of pages (complete) as well as the date you reviewed the page and any notes of importance such as "non-WHO entity page" or check permissions for a figure. Open spaces in your area on this spreadsheet will alert the Editor-in-Chief to continue connecting potential authors with you.
  • Authors who are interested in the area in which you're Associate Editor, will be connected with you for the following Onboarding Process:
  1. Ensure the new author has completed the Volunteer Form.
  2. Create a username and password for a new author (see section below). IMPORTANT: Add the information to the User Access Log.
  3. Refer them to the Author Instructions, which contains information including links to the video tutorial, Word version of page templates, policy on figure inclusion, and how to cite CCGA pages.
  4. Emphasize to authors to please use the supplied tables if applicable.
  5. Once a page is assigned, ensure the author's name is added to the top of the page for clarity that the page is in progress.
  6. If the author is a trainee, ensure they are working with a mentor or perform the mentor function if you're able to do so.
  7. Set up a reasonable due date for the author. For example, propose 4 weeks and if author agrees, send an Outlook invite for that due date that has a one week prior reminder prior to this deadline.
  • After authors indicate a page is "complete", perform Editorial Review:
  1. Review the content for accuracy and appropriate completeness.
  2. Prioritize use of the tables, including helping the author to convert the content or doing so yourself if applicable. If a table is not needed based on current knowledge, remove it so that the page doesn’t look unfinished, but if in the future information is added that could be put in one of the tables, convert it.
  3. Ensure the authors have inserted references in the standard format using the PubMed extension.
  4. Ensure the under construction note at the top of the page has been removed.
  • Once a page has completed content, Add Categories and Page Citation Information:
  1. Add the Categories so that this page is now linked to the searching functions on the homepage (see section below).
  2. Add the citation for the page in the Notes section at the bottom. For example: *Citation of this Page: Naeini Y, Quintero-Rivera F. “Myeloid Sarcoma”. Compendium of Cancer Genome Aberrations (CCGA), Cancer Genomics Consortium (CGC), updated 03/1/2021, https://www.ccga.io/index.php/Myeloid_Sarcoma. See this in action at the bottom of Example.
    1. In order to have the updated section autopopulate on each page, you must use wiki-specific syntax. Therefore, copy this example from the "Edit source" tab and place it in the correct location on the target page using the "Edit" tab or manually type or paste in the yellow highlighted text below.

How to Create a New User Account

  1. Sign into your personal CCGA account
  2. On left side of the homepage, click on “Special pages”
  3. Under the subheading Long/create account, click on “Create account”
  4. Fill out form such as the example below and click "Create account"
  5. As often the automatic email with a temporary password goes to junk mail, that option is not used. Instead, email the new user directly with their account credentials and let them know about the junk mail issue if they have to reset their password.
  6. IMPORTANT: Add the information to the User Access Log.

How to Add Categories to a Page

  1. At the bottom of each page, below the final Notes section, is a box with "Categories" in it. These represent links from the homepage's search options.
  2. To create Categories on a page that doesn't yet have any, log into your account and select the "Edit" tab at the top of the screen.
  3. Click on the hamburger icon on the upper right and select "Categories" from the drop down menu (see image below).
  4. In the box, add in categories appropriate to the page using the exact language of the options available here: All Categories.
  5. Save changes.
  6. Of note, if the page already has categories, they can be edited (deleted or added) in the same place by selecting the "Categories" from the hamburger icon's drop down menu.

Policy for Granting of CCGA Contributor Access

The Compendium of Cancer Genome Aberrations (CCGA) is a crowdsourced resource, with content created and modified in real time by users given a username and password.  This policy defines the process for determining new user access for creating and editing content.

  1. A member of the CCGA Knowledgebase workgroup or Genomic Resources Development Committee (GRDC) may provide access immediately if requested to do so by an individual.
  2. The person who provides access will add the new contributor information into the user access log at User Access Log.
  3. It is encouraged that ABMGG trainees, pathology residents or other post-graduate trainees collaborate with a mentor/sponsor who can help curate their work.
  4. Individuals will be required to review and agree with the “Honor Code for CCGA Content Contributor”.
  5. The GRDC reserves the right to deny CCGA site editorial access to any applicant and to remove access as deemed appropriate.