Difference between revisions of "Author Instructions"

From Compendium of Cancer Genome Aberrations
Jump to navigation Jump to search
[checked revision][checked revision]
Line 5: Line 5:
 
*Authors will be given a username and password by the Associate Editor.  
 
*Authors will be given a username and password by the Associate Editor.  
 
*Author names will be added to the top of any page(s) that they wish to complete so others know they’re in process.
 
*Author names will be added to the top of any page(s) that they wish to complete so others know they’re in process.
*Pages are based on current WHO entries and contain pre-loaded templates (of note, if there’s a non-WHO entity of importance, a new page can be created).  Some authors work from Word templates (see section below; please track references by PMIDs as the site allows for automatic input of references based on PMIDs) and then copy/paste the content into the wiki site or work directly in the wiki site.
+
*Pages are based on current WHO entries and contain pre-loaded templates (of note, if there’s a non-WHO entity of importance, a new page can be created).  Authors are encouraged to work in Word templates (see section below; please track references by PMIDs as the site allows for automatic input of references based on PMIDs) and then copy/paste the content into the wiki site.
 
*There are three types of pages:
 
*There are three types of pages:
  
#Disease category overview pages (for example see [[Acute Myeloid Leukemia (AML) and Related Precursor Neoplasms]], which are summaries of a group of diseases with links to all other relevant content.
+
#Disease category overview pages (for example see [[Acute Myeloid Leukemia (AML) and Related Precursor Neoplasms]]), which are summaries of a group of diseases with links to all other relevant content.  These will typically be completed by Associate Editors.
 
#Disease-specific pages (for example see any links on the AML page), which is for individual disease entities and much more detailed.
 
#Disease-specific pages (for example see any links on the AML page), which is for individual disease entities and much more detailed.
 
#Gene-specific pages (for example see [[ABL1]]).  For additional related instructions see '''[https://ccga.io/index.php/How_to_Curate_a_Gene_Page ''How to Curate a Gene Page'']'''.
 
#Gene-specific pages (for example see [[ABL1]]).  For additional related instructions see '''[https://ccga.io/index.php/How_to_Curate_a_Gene_Page ''How to Curate a Gene Page'']'''.

Revision as of 14:33, 28 September 2021

Introduction

Thank you for your interest in contributing to this community effort. Please find information below of potential use to you as an author.

  • For pages that do not yet have any content, authors will be connected with an Associate Editor based on their disease section(s) of interest. 
  • Authors will be given a username and password by the Associate Editor.  
  • Author names will be added to the top of any page(s) that they wish to complete so others know they’re in process.
  • Pages are based on current WHO entries and contain pre-loaded templates (of note, if there’s a non-WHO entity of importance, a new page can be created). Authors are encouraged to work in Word templates (see section below; please track references by PMIDs as the site allows for automatic input of references based on PMIDs) and then copy/paste the content into the wiki site.
  • There are three types of pages:
  1. Disease category overview pages (for example see Acute Myeloid Leukemia (AML) and Related Precursor Neoplasms), which are summaries of a group of diseases with links to all other relevant content. These will typically be completed by Associate Editors.
  2. Disease-specific pages (for example see any links on the AML page), which is for individual disease entities and much more detailed.
  3. Gene-specific pages (for example see ABL1). For additional related instructions see How to Curate a Gene Page.
  • For more details on how you use the site to be an author, please see an instructional video (see section below). Of note, we highly encourage authors to populate all the tables (i.e. for immunophenotype, chromosomal rearrangements, genomic gain/loss/LOH, etc) when applicable.
  • For the timeline, there’s some flexibility and please work with your Associate Editor to set a target date.
  • Once a page is complete, please:
  1. Delete the statement "This page is under construction. We need you help! Please consider joining in the project and submitting a review".
  2. Email the appropriate Associate Editor that the page is complete.
  • Trainees are highly encouraged and welcome to participate in this effort. Trainees are asked to work with a mentor to help review their page content before completion.
  • For any additional questions, please Contact us. If applicable, please include the disease category you are interested in working on in the subject line (i.e. ALL, mature B-cell neoplasms, etc).
  • For technical issues, please Contact us and include the title of the page on which the error occurred, a screenshot of the error message, the web browser you were using (i.e. firefox, google chrome, internet explorer, etc) and any other pertinent information.

Video Tutorial

  • A video tutorial on how to author in real-time an overview or disease entity-specific page is available: Video Tutorial
  • Similar information is also available in a PowerPoint version: (coming soon)

Word Version Templates

  • Please do use the provided tables if applicable.

Policy for Inclusion of Figures on the CCGA Site

Use of illustrative figures on the Compendium of Cancer Genome Aberrations (CCGA) is encouraged. This policy defines the process for inclusion of a figure.

  1. For figures created by an individual or provided from their lab, the PHI must be removed and the submitter’s name and institution included in the figure legend.
  2. For figures from any other source (such as a website or published paper), a link to the image content, if openly accessible, can be used on the CCGA page.  If such a link is not possible, written permission must be obtained by the person creating the CCGA page before addition to the page.  This written permission should be shared with the Associate Editor of the related section and copied to ccga@cancergenomics.org.  The figure legend should include the appropriate reference and confirmation that permission was obtained.

How to Cite CCGA Pages

  • Citation for a CCGA page on an Author's CV:
  1. Naeini Y, Quintero-Rivera F. “Myeloid Sarcoma”. Compendium of Cancer Genome Aberrations (CCGA), Cancer Genomics Consortium (CGC), created 06/23/2018, https://www.ccga.io/index.php/Myeloid_Sarcoma.
  • Citation in Reports or Other Media:
  1. Naeini Y, Quintero-Rivera F. “Myeloid Sarcoma”. Compendium of Cancer Genome Aberrations (CCGA), Cancer Genomics Consortium (CGC), updated 01/02/2020, https://www.ccga.io/index.php/Myeloid_Sarcoma.