Difference between revisions of "Author Instructions"

From Compendium of Cancer Genome Aberrations
Jump to navigation Jump to search
[unchecked revision][checked revision]
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
==Introduction==
 
==Introduction==
Thank you for your interest in contributing to this community effort.  Please find information below of potential use to you as an author.
+
Thank you for your interest in contributing to this community effort.
  
*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. 
+
*Please complete the [https://mms.cancergenomics.org/members/form.php?orgcode=CGC&fid=3830649 <u>Volunteer Form</u>] and the Editor-in-Chief will be happy to discuss your interests and next steps.
*Authors will be given a username and password by the Associate Editor.  
+
 
 +
#Pages in need of authors can be found here: <u>[[Volunteer Assignments and Opportunities]]</u> (''see “Authors” column and look for any that are not assigned''; every attempt is made to keep this updated). 
 +
#We will be creating content for all entities with genetic findings in the current WHO Classification of Tumours books, Therefore, if there is an entity not yet listed that you would like to author, we would be happy to create a page for you now.
 +
 
 +
*For pages that do not yet have any content, authors will be connected by the Editor-in-Chief with an Associate Editor based on their disease section(s) of interest. 
 +
*Authors will be given a username and password by the Technical 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, which also have expanded helpful notes and instructions (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 two types of pages currently needing authors:
  
#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.
+
#<u>Disease category overview pages</u> (for example see [[Acute Myeloid Leukemia (AML) and Related Precursor Neoplasms|<u>Acute Myeloid Leukemia (AML) and Related Precursor Neoplasms</u>]]), which are summaries of a group of diseases with links to all other relevant content.  These will often be completed by Associate Editors but can be authored by others if interested.
#Disease-specific pages (for example see any links on the AML page), which is for individual disease entities and much more detailed.
+
#<u>Disease-specific pages</u> (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]])
+
#Gene-specific pages (these pages are in the process of being automated for data import and not requiring new authors at this time).
  
*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 more details on how you use the site to be an author, please watch 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.
 
*For the timeline, there’s some flexibility and please work with your Associate Editor to set a target date.
Line 21: Line 26:
  
 
*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.
 
*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 at CCGA@cancergenomics.org.  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 or any additional questions, please '''[Mailto:CCGA@cancergenomics.org <u>Contact us</u>]'''.  If applicable, please 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.
 +
*Can you modify a page that has already been completed by other authors? Yes! The CCGA is a wiki-based platform with the intention that contributors can modify any page at any time if something is not accurate or new evidence and references would be beneficial to share.  This will allow up-to-date accurate content to be available to the community. Primary authorship will typically be listed as those individuals that initially completed the page content, and inquiries can be made by '''[Mailto:CCGA@cancergenomics.org <u>Email</u>]''' if a subsequent user modifies the content and feels the effort put forth is of high enough significance to warrant listing in the authorship section.
  
 
==Video Tutorial==
 
==Video Tutorial==
  
*A video tutorial on how to author in real-time an overview or disease entity-specific page is available: [[Video Tutorial]]
+
*A video tutorial on how to author in real-time an overview or disease entity-specific page is available: [[Video Tutorial|<u>Video Tutorial</u>]]. Revised videos for the recently updated templates will be available in the near future.
*Similar information is also available in a PowerPoint version: (coming soon)
 
  
 
==Word Version Templates==
 
==Word Version Templates==
  
*For a Word document template for authoring a <u>disease-specific page</u> before transferring content online please see [[File:Disease or Entity-Specific Template Word Version (7-5-20).docx|left|thumb]].
+
*For a Word document template for authoring a <u>'''disease-specific page'''</u> before transferring content online please see [[File:Disease or Entity-Specific Template Word Version with Instructions.docx|left|thumb|Disease-Specific Template]].
  
*For a Word document template for authoring an <u>overview page</u> before transferring content online, please see [[File:Disease Overview Template Word Version (7-5-20).docx|none|thumb|Disease Overview Template]].
+
*For a Word document template for authoring an <u>'''overview page'''</u> before transferring content online please see [[File:Disease Overview Template Word Version with Instructions.docx|none|thumb|Disease Overview Template]].
  
*For a Word document template for authoring a <u>gene-specific page</u> before transferring content online please see [[File:Gene-Specific Template Word Version (8-2-20).docx|left|thumb]].
+
*For a Word document template for <u>'''gene-specific page'''</u> [[File:Gene-Specific Template Word Version with Instructions.docx|none|thumb|Gene-Specific Template]].
  
*Please do use the provided tables if applicable.
+
*Note: Additional helpful information and instructions are provided in these Word templates.  If applicable, please do use the provided tables.
  
 
==Policy for Inclusion of Figures on the CCGA Site==
 
==Policy for Inclusion of Figures on the CCGA Site==
Line 48: Line 53:
 
*<u>Citation for a CCGA page on an Author's CV</u>:
 
*<u>Citation for a CCGA page on an Author's CV</u>:
  
#Naeini Y, Quintero-Rivera F. “Myeloid Sarcoma”. Compendium of Cancer Genome Aberrations (CCGA), Cancer Genomics Consortium (CGC), created 2018 June 23, [[Myeloid Sarcoma|www.ccga.io/index.php/Myeloid_Sarcoma]].
+
#Naeini Y, Quintero-Rivera F. “Myeloid Sarcoma”. Compendium of Cancer Genome Aberrations (CCGA), Cancer Genomics Consortium (CGC), created 06/23/2018, <nowiki>https://www.ccga.io/index.php/Myeloid_Sarcoma</nowiki>.
  
 
*<u>Citation in Reports or Other Media</u>:
 
*<u>Citation in Reports or Other Media</u>:
  
#Naeini Y, Quintero-Rivera F. “Myeloid Sarcoma”. Compendium of Cancer Genome Aberrations (CCGA), Cancer Genomics Consortium (CGC), updated 2020 Jan 2 [accessed 2020 July 5], [[Myeloid Sarcoma|www.ccga.io/index.php/Myeloid_Sarcoma]].
+
#Naeini Y, Quintero-Rivera F. “Myeloid Sarcoma”. Compendium of Cancer Genome Aberrations (CCGA), Cancer Genomics Consortium (CGC), updated 01/02/2020, <nowiki>https://www.ccga.io/index.php/Myeloid_Sarcoma</nowiki>.

Revision as of 19:31, 1 January 2022

Introduction

Thank you for your interest in contributing to this community effort.

  • Please complete the Volunteer Form and the Editor-in-Chief will be happy to discuss your interests and next steps.
  1. Pages in need of authors can be found here: Volunteer Assignments and Opportunities (see “Authors” column and look for any that are not assigned; every attempt is made to keep this updated). 
  2. We will be creating content for all entities with genetic findings in the current WHO Classification of Tumours books, Therefore, if there is an entity not yet listed that you would like to author, we would be happy to create a page for you now.
  • For pages that do not yet have any content, authors will be connected by the Editor-in-Chief with an Associate Editor based on their disease section(s) of interest. 
  • Authors will be given a username and password by the Technical 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, which also have expanded helpful notes and instructions (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 two types of pages currently needing authors:
  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 often be completed by Associate Editors but can be authored by others if interested.
  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 (these pages are in the process of being automated for data import and not requiring new authors at this time).
  • For more details on how you use the site to be an author, please watch 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 technical issues or any additional questions, please Contact us. If applicable, please 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.
  • Can you modify a page that has already been completed by other authors? Yes! The CCGA is a wiki-based platform with the intention that contributors can modify any page at any time if something is not accurate or new evidence and references would be beneficial to share. This will allow up-to-date accurate content to be available to the community. Primary authorship will typically be listed as those individuals that initially completed the page content, and inquiries can be made by Email if a subsequent user modifies the content and feels the effort put forth is of high enough significance to warrant listing in the authorship section.

Video Tutorial

  • A video tutorial on how to author in real-time an overview or disease entity-specific page is available: Video Tutorial. Revised videos for the recently updated templates will be available in the near future.

Word Version Templates

  • Note: Additional helpful information and instructions are provided in these Word templates. If applicable, please do use the provided tables.

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.