Personal tools
You are here: Home → Editors → Guidelines for Reviewers

Guidelines for Reviewers

Adding/Editing/Reviewing Articles for GAMEO as an Reviewer

To be a GAMEO Reviewer

Reviewers (Senior Editors) have a lot of power in GAMEO-- they can change any article in the encyclopedia, add images and maps to articles, and decide whether newly written articles are ready for "publishing," which makes the article visible to the public. Of course, they can also write new articles themselves.

To be a GAMEO Reviewer, you need to have experience as a GAMEO editor. See Guidelines for Editors. You will also need to be a registered user with a Login Name and a Password. These are initiated by one of GAMEO’s Managing Editors – Sam Steiner, Librarian & Archivist at Conrad Grebel University College, Waterloo, Ontario or Richard Thiessen, Librarian at Columbia Bible College in Abbotsford, British Columbia.

As a GAMEO editor you had your own Login Name and password. You can continue to use that Login and password. Or, if you wish a separate Login name and password for the reviewer function, please let one of the Managing Editors know. This can be arranged.

If you have any suggestions to improve these guidelines, get in touch with Sam Steiner or Richard Thiessen.

Your Dashboard

When you login you will see your name on the righthand side of the gold bar near the top. Clicking on this link will bring you to your personal “Dashboard.” You will see three “portlets” on the page – with News, Upcoming Events and Recent Articles. As a Reviewer, you will also see a review list of articles that have been marked as ready for review by editors.

For information on other basic information in the Dashboard, see Guidelines for Editors.

Writing a New Article (Same for Reviewer as for Editor)

To write a new article, see Guidelines for Editors.

Quick Edits to Existing Articles

As a Reviewer, you can edit any article in GAMEO; you do not need to send it back to the article's writer or "owner." You will most often do this to add a link to another article (see Backlinks below). Otherwise you should generally edit articles in this way only for obvious typos, grammatical problems, changed information, etc. If you make a change in dates or spelling, be sure you're right! Articles that require a more extensive edit should usually returned to the writer or owner of the article.

  1. Search for the article you wish to edit.
  2. Change article state to modify, and then to edit
  3. Make the necessary changes and save.
  4. Review the article for appearance, then click on "State" and select "Submit for Review," followed by "Publish"
  5. The correction is now available to the public.
  6. PLEASE NOTE: Currently an error within Plone means that maps attached to articles (see Adding Maps) disappear when articles are modified/edited. This means you need to check if an article has a map attached before editing it. If yes, note the name of the map and remember to add the map again when you are done with the edit.

Reviewing Articles Posted as Ready for Publication

If your dashboard lists articles ready for review, you can choose to "publish" the article or to "reject" the article. (The Dashboard lists all articles ready for review, not just articles with which you may have been involved.) It is best to only review articles with which you have an organizational connection -- e.g. you're a reviewer from the Canadian Editorial Group looking at an article from Manitoba, or you're from the Lancaster Editorial Group looking at a Pennsylvania-related article.

  1. Click on the article you wish to review for publication
  2. Carefully review the article
    1. Does it follow our stylesheet?
    2. If applicable, does it follow the appropriate subject template? (biography, congregation, etc.)
    3. Is the spelling American style? (That's our standard -- sorry Canadians)
    4. Have all the links to other articles been made that should have been made?  (see Creating Backlinks for some tricks to finding all relevant articles)
    5. Check the html view; is there a lot of garbage in the coding (probably from a copied Word document!)
    6. Does the bibliography follow our style guidelines?
  3. Add an image or map, if this has been requested by the editor/writer.
  4. If there are only a few minor corrections, feel free to make them yourself. Then save the changes, and under the "State" dropdown, click "Publish."
  5. If substantial changes need to be made, click "Reject." This sends the article back to "Draft" status. You should send an email to the editor, explaining the reasons for your action.
  6. If you have published a new article, you will need to create the backlinks to this article. When these are completed, go on to the next article to be reviewed.

Creating Backlinks to New Articles

When an editor creates a new article, they are able to create links to other articles that come up in the article -- personal names, institutions, congregations, places, etc. However they are not able to create links back to the new article from already existing articles. That's one of your tasks.

  1. Do a search on the name of the new article. If you don't get hits that you would expect, try alternative spellings, or just use the last name of the individual. Don't use initials in the search -- they tend to reduce hits. If you get more hits than you expect, try putting the phrase in quotation marks. (The normal search assumes an "and" between the words, but not adjacency.)
  2. Go down the list of hits one by one. Use your browser search function to confirm the reference is to the correct place, person or institution. Then open the article and make the link to the new article as you would make any link. In a short article, make the link only once, even though the name of the article may appear multiple times. In a long article, you may wish to repeat the link more than once.
  3. Review the article for appearance, then click on "State" and select "Submit for Review," followed by "Publish"
  4. The article with new link is now available to the public. Go to the next article in the hit list.

Adding Images to GAMEO database or to articles

You may receive an image from an editor, or on your own initiative you may choose to add one or more images to an article. Please use the following guidelines:

  1. Be sure you have the rights to publish the photo to the web. If it comes from an archives or private individual or insitution, you need permission. Most pictures on the web may not be copied because of copyright questions. The major exception is Wikipedia. However if you want to use a Wikipedia picture, click the picture in the Wikipedia article and check the statement on whether the photo is in the public domain before using it.
  2. The best image is usually about 800 pixels on the long side. The format should be a jpg of moderate to low density (in order to save space on the server -- GAMEO pays for the size of the database). If the image has been sent to you in very high quality, and thus is very large, you should reduce it in a photo edit program. The saved image should not exceed 100 kb in size. If the image is a portrait, it can be smaller than 800 pixels on the long side. Some old photos simply need to be smaller because they are of poor quality.
  3. The image should be optimized for contrast. You can also use a program like Photoshop Elements to "clean up" spots or lines on old photographs.
  4. Have the copy you want to upload saved in a logical place -- your computer's desktop, or a GAMEO images file.
  5. From the "Welcome" page, click on "Contents." This brings up a folder list.
  6. Click on "images."
  7. Click on "Add image."  This brings up a template not unlike the article template.
  8. Choose and fill in a title for the image. Do not use exactly the same title as an article; this adds to a "duplicate titles" list generated by plone. For a place, you might choose to leave off the name of the country; for a person, you might leave off one of the dates.
  9. In the "Description" field fill in the name and source of the photo, and a link to the original if it's on the web, e.g. Heinrich Bullinger. Source: Wikipedia Commons http://en.wikipedia.org/wiki/Image:Heinrich_Bullinger.jpg.

    It make the image more searchable to have a full name in this field, and the link is useful for persons who later may wish to add the image to another article.
  10. Click on "browse" and find the image on your computer.
  11. Click on "save."  After the image is uploaded, it will display on your screen.
  12. If you want to add more images, click on "images" in the Home -->images-->[your saved image] "breadcrumb" line under the tabs; this will bring you back to the top of the images folder where you go to step 7 again. If you are done, go to the article you want to add the image to, or go wherever else you want to go.
  13. If you wish now to insert an illustration into an article, go the paragraph in the article where the illustration is to be placed. Click on the table box. Indicate there will be two rows and one column in the table. Uncheck the box for "Create Heading." Then click "Add table." This will create an empty table above the paragraph where you wish the illustration. With the cursor in the top cell of the table, click on the "tree" to find an image. The search box will in the images folder -- search for the image, you can use the file name of the image if you know it. When you select the right image, it will give you a choice on the size of the image to be displayed in the picture. Our default is the "mini" 200 x 200 pixels. In the bottom cell of the table place the caption for the illustration. This usually also includes the source of the image. Highlight the caption, click on the dropdown edit box and select the style "Image subtext." This creates italicized text in a slightly smaller font. Now click on the image that is in the top cell and click on the "chain" to create a link to the full size of the image. You should be able to search again for the image. Now you need to decide whether you want the image table to be on the left or on the right. Click on "html" and look for the line that reads "<table class="plain">". It should contain your caption and other html code. Now insert align="left" or align="right" just before the last angle, i.e.  <table class="plain" align="left">. Be sure there is a space between "plain" and "align". Click on "html" again and you should see the image where you want it! If not try again, or ask for help from a managing editor. Click on "save."
  14. Review the article for appearance, then click on "State" and select "Submit for Review," followed by "Publish"
  15. The article with new image is now available to the public.

Adding Google Maps to the Database or to articles

  1. From the "Welcome" page, click on "Contents." This brings up a folder list.
  2. Click on "maps"
  3. Click on "Add new.." dropdown menu and click on "location." This brings up a template not unlike the article template.
  4. Choose and fill in a title for the map. Do not use the same title as an article; this adds to a "duplicate titles" list generated by Plone. You might, for example, choose to leave off the name of the country.
  5. In the "Description" field fill in the location shown in the map. It make the maps more searchable to have a full name in this field.
  6. Fill in "Location" with the address you want a map for, e.g. 140 Westmount Road North, Waterloo, Ontario
  7. Click search.
  8. When the result comes up, remove the balloon containing the address (click the x in the upper right).
  9. If the result is OK, click save, otherwise search again.
  10. If you want to add more images, click on "images" in the Home -->maps-->[your saved map] "breadcrumb" line under the tabs; this will bring you back to the top of the maps folder where you go to step 3 again. If you are done, go to the article you want to add the map to, or go wherever else you want to go.
  11. If you wish now to add a map to an article, go the "Locations" spot in the article (in the edit template). This is just after the "Additional Information" box and before where authors are entered at the bottom. Click on "Add". A popup screen appears called headed by "Locations". If the popup screen does not appear, the security on browser is restricting popups, and should be adjusted to accept popups from gameo.org. Currently the steps are somewhat cumbersome; we hope to change this in the near future. Click on "Home" in the breadcrumb line (with arrows) at the top. Now click on "maps." If you've just added the map, scroll to the bottom and click on the last page number shown. (The maps are added to the folder in the order they are created.) Click "insert" next to the map you want. At the top of the popup it should now indicate a reference has been added to your map. Click "close window." Under "Locations" it should now list your map with a checkmark next to it. Save the article (when done with whatever other changes are needed). 
  12. Review the article for appearance, then click on "State" and select "Submit for Review," followed by "Publish"
  13. The map is now available to the public (under locations) at the bottom of the article.

Adding Sound or Video to an Article

We have not yet set up the protocols for this.

Deleting an Article

Reviewers are not able to delete articles. If an article should be deleted (it's a duplicate) send an email to a Managing Editor and ask that the article be removed. 

Last modified 15 September 2008

 

Document Actions