Changes

no edit summary
Line 79: Line 79:  
##<u>Visual mode (likely preferred method)</u> <br />[[File:Editor04.png|frameless|900x900px]]    <br />''Red text'' means removed and the ''Green text'' means added.  The functionality will be similar to popular document creation software.
 
##<u>Visual mode (likely preferred method)</u> <br />[[File:Editor04.png|frameless|900x900px]]    <br />''Red text'' means removed and the ''Green text'' means added.  The functionality will be similar to popular document creation software.
 
##<u>Wikitext mode</u>  <br />There is more functionality in this mode to manipulate the wiki syntax (for advanced editors this may be the best way to review long pages and also to spot syntax errors)
 
##<u>Wikitext mode</u>  <br />There is more functionality in this mode to manipulate the wiki syntax (for advanced editors this may be the best way to review long pages and also to spot syntax errors)
#To approve/disapprove edits, go to the “Review this revision” box at the bottom of the page (see image below).  IMPORTANT NOTE: You can only accept or reject all the new revisions that were saved together at once (cannot accept some and reject some) – if only some changes are desired, the Associate Editor will need to reject the revision and then manually re-edit the page to add in the new wanted changes or accept all the changes and manually remove the new ones that are not desired.  
+
#To approve/disapprove edits, go to the “Review this revision” box at the bottom of the page (see image below).   
##Associate Editors can choose the quality of the revision So something may be approved even though it is marked with a low quality in (let’s say) readability.
+
##IMPORTANT NOTE: You can only accept or reject all the new revisions that were saved together at once (cannot accept some and reject some) – if only some changes are desired, the Associate Editor will need to reject the revision and then manually re-edit the page to add in the new wanted changes or accept all the changes and manually remove the new ones that are not desired.
 +
##Associate Editors can choose the quality/style of the revision (accuracy, depth and readability).
 
##If an Associate Editor chooses to disapprove the revision, a comment can be made for the reasoning.  <br />[[File:Editor07.png|frameless|600x600px]]      <br />'''<u>Until revisions are approved, they will not appear as the default view for a page.</u>'''  <br />
 
##If an Associate Editor chooses to disapprove the revision, a comment can be made for the reasoning.  <br />[[File:Editor07.png|frameless|600x600px]]      <br />'''<u>Until revisions are approved, they will not appear as the default view for a page.</u>'''  <br />
#Once editorial review is complete, please indicate the date in the corresponding “Date of Last Editor Review” column of the Volunteer Assignments and Opportunities page.
+
#Once editorial review is complete, please indicate the date in the corresponding “Date of Last Editor Review” column of the [[Volunteer Assignments and Opportunities]] page.
   −
====Conversion Notes:====
+
====Book Conversion (Moving Content to a New WHO Book; HAEM4 to HAEM5 as an example):====
    +
*Content moved from a prior page will be present beneath a purple instructional box (see example image below).  The author should use that content and other current sources to update the content in the related section above it.  You can then have the authors or you delete the old content and purple instructional boxes.
 +
**Note: The purple instructional boxes can be TRICKY to remove and so if you need help, please don't worry about it and just email CCGA@cancergenomics.org when the page is complete to get help on the removal.
 
**Note: Most testing for this process has used Google Chrome as the browser. Other browsers may have issues in transferring data between sections.
 
**Note: Most testing for this process has used Google Chrome as the browser. Other browsers may have issues in transferring data between sections.
   −
For the HAEM4 to HAEM5 book conversion, several key automatic processes have been performed:
+
For the HAEM4 to HAEM5 book conversion, several key automatic processes were performed with the following page conversion types:
   −
#HAEM4 pages have been assigned to HAEM5 counterparts when possible
+
#Note: HAEM4 content have been assigned to HAEM5 counterparts when possible.
##It is possible for a HAEM5 page to be entirely new, to need content brought in from more than one HAEM4 page, or for a single HAEM4 page to be divided into several HAEM5 pages. It is also possible for an original HAEM4 page to no longer be relevant, and therefore to not be assigned to a HAEM5 page.
+
##New disease entity in HAEM5 - no prior content to convert (add content from scratch).
##The automated process has attempted to uplift older templates to the current template when possible. This changes the structure of several key tables in particular. Please take the relevant content from each section and incorporate it into the new section.
+
##Disease entity only in HAEM4 and not in HAEM5 - no content was converted.
 +
##Same disease entity exists in HAEM4 and HAEM5 but no prior content added into HAEM4 page - no content to bring over to HAEM5 page (add content from scratch).
 +
##Same disease entity exists in HAEM4 and HAEM5 with prior content added into HAEM4 page - content brought in from HAEM4 page (update content).
 +
##Disease entity in HAEM5 represents multiple diseases in HAEM4 - Content from most completed HAEM4 page added to HAEM5 page with notes in conversion instructions on the HAEM5 page indicating all the relevant HAEM4 pages to consider for content (update content).
 +
##Disease entity in HAEM4 is now split into multiple disease entities in HAEM5 - Notes in conversion instructions on each relevant HAEM5 page indicate the relevant HAEM4 page to consider for content (update content).
 +
##Note: The automated process has also attempted to convert older template structure to the current template on all HAEM5 pages when possible. This changes the structure of several key tables in particular. Please take the relevant content from each section and incorporate it into the new sections.
    
[[File:HAEM4 content example.png||frameless|900x900px]]
 
[[File:HAEM4 content example.png||frameless|900x900px]]
   −
#If a HAEM5 page has one of more HAEM4 pages, the contents of one of the pages will have been automatically transferred. The relevant pages HAEM4 pages can be found in the conversion nots box at the top of each page. The first indicated page will have had its contents transferred. Other relevant pages will be listed as well. If relevant pages were empty or if no relevant pages were identified, there will not be a conversion box.
+
If a HAEM5 page has one or more HAEM4 pages, see example below of the contents of one of the pages being automatically transferred and that all the relevant pages HAEM4 pages are listed in the Conversion Notes box at the top of each page. The first indicated page is the one that had its contents transferred. If relevant pages were empty or if no relevant pages were identified, there will not be a Conversion Notes box.
    
[[File:HAEM4 conversion example.png||frameless|900x900px]]
 
[[File:HAEM4 conversion example.png||frameless|900x900px]]
Line 102: Line 110:       −
 
+
<u>Extra functionality if of interest</u> - Browsing history interactively (see image below): Each revision represents a single "save" by an author/editor. There may be multiple revisions to review, and '''each revision may have multiple changes within it'''. A visual representation of the changes can be used to select and approve a subset of the changes. However, for any revision to be accepted, all previous revisions must also be accepted. To visualize the changes, click on the “Browse history interactively” bar on the top and compare different versions:  <br />[[File:Editor06.png|frameless|900x900px]]  <br />
There are several ways to view the revisions. Each revision represents a single "save" by an author/editor. There may be multiple revisions to review, and '''each revision may have multiple changes within it'''. A visual representation of the changes can be used to select and approve a subset of the changes. However, for any revision to be accepted, all previous revisions must also be accepted. To visualize the changes, click on the “Browse history interactively” bar on the top and compare different versions:  <br />[[File:Editor06.png|frameless|900x900px]]  <br />