Editor wiki: Difference between revisions

From GCD
Jump to navigation Jump to search
(don't add too many issues to an existing series!)
m (→‎Becoming an Editor: bullet formatting)
 
(39 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[Dealing with the Error List]]


[[Genre List]] Excel list of all words or phrases used as genres
==Duties of an Editor==
Per a [http://www.comics.org/voting/ballot/144/ Board vote of 2012-09-04]:
# An editor must join the editor mailing list to stay current with topics. While not required to participate, they must read the posting on the mailing list and follow the discussions with attention. Joining the policy list, while not required, is recommended.
# An editor must be committed to following and enforcing the formatting rules as currently set forth. Where the formatting documentation is not clear the editor should seek the advice of other editors to determine if data has been entered satisfactorily. Consultation of other editors can happen either on the Editor list or by placing an index in discussion mode, or both, depending on the circumstances of the situation.
# The duty of an editor is the approval of indexes and covers. As often as possible an editor should log into the pending queue and examine indexes for approval. Editors may also check the error list and make such corrections as they are able and willing.
# Editors should also be willing to help mentor new indexers.


[[Problem series]] that need to be worked on
==Becoming an Editor==
Per a [http://www.comics.org/voting/ballot/144/ Board vote of 2012-09-04]:
# Indexer must have done enough indexing to have become a voting member of the GCD.
# Indexer has indexed some complete books, as opposed to just tiny changes to already existing indexes.
# Indexer has satisfactorily demonstrated that they follow the current indexing rules, so far as our "rules" are codified
# Indexer has either asked to become, or another editor has proposed them to be appointed as an Editor.
# Elections:
#* Require that all votes to grant Editor status must have a quorum of at least 50% plus 1 of the eligible Editors voting to be valid.
#* Require that all votes to grant Editor status must have at least 75% yes votes of those Editors voting on the question to be valid.


A somewhat accurate [[list of editors]]
==Approving Covers==
 
[[Reviewing and Approving Covers]]
Formatted version of the GCD [[Cheat Sheet]]
 
[[Information Storage]] Page - a place to put information for preservation
 
==Editing vs. Indexing==
Keep the two roles distinct in your mind. If you want to do "Indexer" type work, stay in the Indexing pane. Lots of editors have started indexing their books in the Database pane, which causes orphaned indexed issues that don't know who indexed them. If you are doing "Editor" type stuff, that's when you should use the Pending and Database panes.


==Approving Indexes==
==Approving Indexes==
Go to the Pending pane.  There are links to all the comics that have been finished by the indexer but not yet approved by the editors. There are also links to the indexer's e-mail so you can easily let them know that there is something wrong with their index and a preview link that will show you what the issue will eventually look like (almost, it's not the exact same as the regular issue view page, for instance it will show all the "none" entries as opposed to the regular one with recognizes those as irrelevant and edits them out). There is also an edit button which brings you to the page to edit the content if need be.
Go to the Pending tab after logging in.  There are links to all the publishers/imprints/comics etc. that have been finished by an indexer but not yet approved by an editor.  Clicking on the Name of the change will take you to a Change Point screen where the before and after of the change will be shown. Any field highlighted in yellow has been changed.  At the bottom of the page are Assign and Add Comment buttons. Assigning will put the index into your Reviewing queue, ready for approval or rejection back to the indexer.
 
To approve an index, check the box on the right of the line that the index is on and then click the "Approve Selected" button at the bottom of the page. '''Do not approve books in the database screen by using the dropdown''' This is really important, since it can lead to orphaned indexes that aren't attributed to any indexer.  Never approve indexes from inside the database. Approve from the pending list only.


===Things To Check When Approving an Index===
===Things To Check When Approving an Index===
* When approving an index in the pending queue, do not forget to check the key date. This is one of the most commonly overlooked fields.  Always check the EDIT THIS ISSUE to make sure the keydate and other information is correct.
* Cover sequence includes the total page count for the entire issue.
* Cover sequence includes the total page count for the entire issue.
* Most (but not all) comics have a total GCD page count of 8n + 4. If a new indexer submits an index with a cover page count that is either an exact multiple of 8 or that is not a multiple of 4, the total page count should be confirmed before the index is approved.
* Most (but not all) comics have a total GCD page count of 8n + 4. If a new indexer submits an index with a cover page count that is either an exact multiple of 8 or that is not a multiple of 4, the total page count should be confirmed before the index is approved.
Line 30: Line 33:
** If less than 4 of these are present, or the Format information is missing or inadequate, the indexer should be contacted for more information.
** If less than 4 of these are present, or the Format information is missing or inadequate, the indexer should be contacted for more information.
* Stories/features table:
* Stories/features table:
** If the numbering here is not consecutive, (or contains duplicate numbers), then there is a problem.
** Interior sequences should have:
** Interior sequences should have:
** Page count - or explanation of missing count
** Page count - or explanation of missing count
** Feature - unless a story is not part of an ongoing "strip", or the sequence is a minor Type like Ad or Promo
** Feature - unless a story is not part of an ongoing "strip", or the sequence is a minor Type like Advertisement or Promo
** all Credits fields except Editor - with an exception for minor Types like Ads & Promos?
** all Credits fields except Editor - with an exception for minor Types like Ads & Promos?
* Use the "Series info" link to compare the SeriesBegan and SeriesEnded dates on the Series information page with the Publication dates of the first & last issues. If these do not match, contact the indexer to find out whether the Series or Issue date information is wrong.
* Use the "Series info" link to compare the SeriesBegan and SeriesEnded dates on the Series information page with the Publication dates of the first & last issues. If these do not match, contact the indexer to find out whether the Series or Issue date information is wrong.
* Check the cover scan (if present). On recent comics, the credits printed on the cover are a good way to "spell-check" the indexed credits.
* Check the cover scan (if present). On recent comics, the credits printed on the cover are a good way to "spell-check" the indexed credits.
* Add up the interior sequence Page count fields. The sum of these should be 1-20 pages less than the Cover Page count field (depending on whether or not Ads & Promos have been indexed).
* Add up the interior sequence Page count fields. The sum of these should be 1-20 pages less than the Cover Page count field (depending on whether or not Ads & Promos have been indexed).
* Check that "Story" Type sequences are actually stories - since Story is the default Type, sometimes Text stories or other Types are indexed as a "Story" by accident. (If a "Story" has "none" in the Pencils & Inks fields, this is a good sign that something is wrong.)
* Check that "Story" Type sequences are actually stories - since Story used to be the default Type, sometimes Text stories or other Types were indexed as a "Story" by accident. (If a "Story" has the "No Pencils" and "No Inks" boxes checked, this is a good sign that something is wrong.)
 
==Is the site down?==
'''PINGING THE SERVER'''
At the command prompt, type "ping www.comics.org". The command prompt is reached, through Windows, by Start --> Programs --> Accessories --> Command prompt . ping reports whether or not a machine is reachable over the 'net.
 
If ping fails, it means either the machine is not running, or there is a problem with the network connection between you and it, or the machine's administrator has configured the machine to ignore ping (the latter is not the case with our server). If it succeeds, that means that the machine is up and there is a network path between you and it.
 
If ping succeeds but you can't access the main page, then that means there's a problem with the web service running on the machine.
 
If you can reach the main page, but can't access the database (the OI or the search pages), then the web server is running but either the database is down, the middleware is down, or one of the connections between the three is broken. The middleware (software that passes data from the web server to the database and back) in our instance is django.
 
==Approval workflow for the new site==
[Issue is not reserved]
 
1.  Indexer makes change and submits.
 
[Issue reserved to Indexer and appears in Pending queue.]
 
2.  Editor assigns a submitted change to himself for review.
 
[Issue still reserved to Indexer, but also in Assigned state.]
 
2.  Indexer and Editor may go back and forth discussing, Indexer may make additional changes.
 
[Issue still reserved to Indexer but may be in either Pending or Assigned state.]
 
3.  Editor either approves the change if Indexer has made appropriate changes, OR rejects the change if Indexer has refused.
 
[Issue changes are *live* on site if approved, OR are discarded if rejected.]
 


==Creating a Series==
NOTE:  If you, in the role of Editor, just want to comment on the change in a way that is visible in the change history but doesn't show up on the index page, there *is* a field for that that does *not* require assigning the issue to yourself. Only fields that display in the index page require approval, such as the regular Notes field.
First ensure that the series doesn't already exist.  Then click on the Database tab, and search for the publisher first and then click the Add Series link. Make sure you fill out both start and end years and start and end issue numbers, even if the series is ongoing. Use 9999 for the year and whatever the current issue number is for the issue. If either of these are blank, series updates may not take later on unless someone sees the blanks in these fields.


This then leads to a screen to add issues.


==Adding Issues to an Existing Series==
==Variant Issues==
To add issues to a series, search for the series and drill down into it. There are two links, "add issue" and "add multiple". The easier method is to add multiple at once. This just takes a start number and and end number and fills in all the issues in between. This obviously won't fill in funky numbers (alpha, infinity, 1000000, 1.5, etc.). For that you need the add single issue link. The thing with that is that you have to make sure you enter the correct cover sort code.
A link to the page detailing how to handle [[Variant Issues]].


A general rule is not to work ahead more than three months or so for a monthly series. Exceptions are mini-series, which are often set up in one go, as the final issue is already announced (although of course not certain, as the series may be expanded or cancelled prematurely).
==Error Tracker==


==Additional Resources for Editors==
[[Error Tracker Workflow|Dealing with the Error List]]
There are couple of additional editor pages you should know about.  Email an editor for these links.


One is the keydate page, where you can see all the issues in a series and their keydates. The keydate field is used to sort the issues in the issue matrix. The format is YYYY.MM.DD to mirror the date on the issue.
==List of Editors==


If you want to quickly check an entire series or run of issues for problems with KeyDates, check the "See index matrix" link from the Series information page - if the indexed and/or pending issues are not in the proper order, a KeyDate error is usually the cause of it.
Current and past [[list of editors]]


Another is the cover sort code page. Cover sorting is completely separate from issue sorting. If covers sort in the wrong order, it can be very tricky to fix them. BY FAR, the easiest way is if the series only has "normal" issue numbers - 1, 2, 3, 4, etc. For these, go to the regular cover gallery page and you should see a link "Good riddance, fix this mess". This will automatically sort all the covers numerically. '''DO NOT''' use this link for any series with "odd" issue numbers like 1000000, 0, alpha, etc. They will all sort at the beginning or the end and it will be a huge pain to fix them.
==GCD Cheat Sheet==


To fix series with odd covers, use the above stickyscan page. To change a cover sort code, you will need to:
Formatted version of the GCD [[Cheat Sheet]]


# save a copy of the large scan to your local hard drive
# go into the OI Database pane, bring up the issue and click the link underneath the cover to delete the cover
# go to the stickyscan page and change the cover sort code
# upload the cover that you saved in step a


Going back to the "add single issue" comments above where you need to enter the correct cover sort code, the stickyscan link is how you find out what that sort code should be. Say a series has issues 1 and 3 set up as skeletons. You want to add issue 2. You would obviously enter "2" as the issue number, but it is not safe to assume the value of the cover sort code. If you assume it should be "2", and cover sort codes for issues 1 and 3 are set to "01" and "03", the covers will eventually sort in the order 1-3-2. You need to go to the stickyscan page to check what 1 and 3 are set to and adapt the new issue 2's cover sort code accordingly.
==Style Guide==
Working document [[Style Guide]]


==Reserving Indexes to Other Indexers==
==Information Storage==
In the OI Database pane again, when viewing in issue you may see dropdown lists to select indexers (indexed pre-OI issues and new skeletons) and issue status (all issues). To reserve a new issue to someone, just select their name in the indexer dropdown and change the status to Initiated. This is also where you can change a Pending index back to Initiated. It's not uncommon that an editor is working with an indexer on a pending index and some other editor comes along and doesn't see the same problem and approves the index. It's usually best if you're working with an indexer to punt the issue out of the Pending queue so no one can make that mistake. Never '''UPGRADE''' an issue via this dropdown. When I mentioned earlier about remembering to do your indexing work in the Indexing pane instead of the Database pane, this is what I was talking about. Some editors have forgotten and entered all the sequence info in the Database pane and then just changed the dropdown to "Approved". '''DO NOT DO THIS'''. This is bad. This is wrong. We need a newer, stronger word like badwrong or badong.


==Updating the number of issues in a series==
[[Information Storage]] Page - a place to put information for preservation
If you delete an issue from a series, the number of issues on the search.lasso page doesn't update automatically.  You can get it to update if you do an edit on the series page in the database.  Something minor like adding a period will do the trick.


==Is the site down?==
==Unreleased Series Reservations==
'''PINGING THE SERVER'''
At the command prompt, type "ping www.comics.org". The command prompt is reached, through Windows, by Start --> Programs --> Accessories --> Command prompt . ping reports whether or not a machine is reachable over the 'net.


If ping fails, it means either the machine is not running, or there is a problem with the network connection between you and it, or the machine's administrator has configured the machine to ignore ping (the latter is not the case with our server). If it succeeds, that means that the machine is up and there is a network path between you and it.
[[Unreleased Series Reservations|Reservations for series that have yet to be released]]


If ping succeeds but you can't access the main page, then that means there's a problem with the web service running on the machine.
-----
[http://docs.comics.org/w/index.php?title=Editor_wiki&oldid=605 Last version before going to non-lasso site]
<br>
Retained for historical purposes only.
----


If you can reach the main page, but can't access the database (the OI or the search pages), then the web server is running but either the database is down, the middleware is down, or one of the connections between the three is broken. The middleware (software that passes data from the web server to the database and back) in our instance is Lasso.
[[Category: Editor Wiki]]

Latest revision as of 18:44, 24 May 2023

Duties of an Editor

Per a Board vote of 2012-09-04:

  1. An editor must join the editor mailing list to stay current with topics. While not required to participate, they must read the posting on the mailing list and follow the discussions with attention. Joining the policy list, while not required, is recommended.
  2. An editor must be committed to following and enforcing the formatting rules as currently set forth. Where the formatting documentation is not clear the editor should seek the advice of other editors to determine if data has been entered satisfactorily. Consultation of other editors can happen either on the Editor list or by placing an index in discussion mode, or both, depending on the circumstances of the situation.
  3. The duty of an editor is the approval of indexes and covers. As often as possible an editor should log into the pending queue and examine indexes for approval. Editors may also check the error list and make such corrections as they are able and willing.
  4. Editors should also be willing to help mentor new indexers.

Becoming an Editor

Per a Board vote of 2012-09-04:

  1. Indexer must have done enough indexing to have become a voting member of the GCD.
  2. Indexer has indexed some complete books, as opposed to just tiny changes to already existing indexes.
  3. Indexer has satisfactorily demonstrated that they follow the current indexing rules, so far as our "rules" are codified
  4. Indexer has either asked to become, or another editor has proposed them to be appointed as an Editor.
  5. Elections:
    • Require that all votes to grant Editor status must have a quorum of at least 50% plus 1 of the eligible Editors voting to be valid.
    • Require that all votes to grant Editor status must have at least 75% yes votes of those Editors voting on the question to be valid.

Approving Covers

Reviewing and Approving Covers

Approving Indexes

Go to the Pending tab after logging in. There are links to all the publishers/imprints/comics etc. that have been finished by an indexer but not yet approved by an editor. Clicking on the Name of the change will take you to a Change Point screen where the before and after of the change will be shown. Any field highlighted in yellow has been changed. At the bottom of the page are Assign and Add Comment buttons. Assigning will put the index into your Reviewing queue, ready for approval or rejection back to the indexer.

Things To Check When Approving an Index

  • Cover sequence includes the total page count for the entire issue.
  • Most (but not all) comics have a total GCD page count of 8n + 4. If a new indexer submits an index with a cover page count that is either an exact multiple of 8 or that is not a multiple of 4, the total page count should be confirmed before the index is approved.
  • Writer field need not be filled in the cover sequence. Editor field only needs to be in the cover sequence unless there is a change.
  • Check for required fields (or even entire sequences) that are missing. This can be hard to do sometimes, because most fields do not show up on the website unless they are filled in - so you have to remember to "look for what is not there" as well as looking at what has been entered.
  • Here are some places to look:
    • Cover sequence - should have 4 fields filled in above the Format information:
    • Publisher, Publication date, Cover price, Total page count.
    • If less than 4 of these are present, or the Format information is missing or inadequate, the indexer should be contacted for more information.
  • Stories/features table:
    • Interior sequences should have:
    • Page count - or explanation of missing count
    • Feature - unless a story is not part of an ongoing "strip", or the sequence is a minor Type like Advertisement or Promo
    • all Credits fields except Editor - with an exception for minor Types like Ads & Promos?
  • Use the "Series info" link to compare the SeriesBegan and SeriesEnded dates on the Series information page with the Publication dates of the first & last issues. If these do not match, contact the indexer to find out whether the Series or Issue date information is wrong.
  • Check the cover scan (if present). On recent comics, the credits printed on the cover are a good way to "spell-check" the indexed credits.
  • Add up the interior sequence Page count fields. The sum of these should be 1-20 pages less than the Cover Page count field (depending on whether or not Ads & Promos have been indexed).
  • Check that "Story" Type sequences are actually stories - since Story used to be the default Type, sometimes Text stories or other Types were indexed as a "Story" by accident. (If a "Story" has the "No Pencils" and "No Inks" boxes checked, this is a good sign that something is wrong.)

Is the site down?

PINGING THE SERVER At the command prompt, type "ping www.comics.org". The command prompt is reached, through Windows, by Start --> Programs --> Accessories --> Command prompt . ping reports whether or not a machine is reachable over the 'net.

If ping fails, it means either the machine is not running, or there is a problem with the network connection between you and it, or the machine's administrator has configured the machine to ignore ping (the latter is not the case with our server). If it succeeds, that means that the machine is up and there is a network path between you and it.

If ping succeeds but you can't access the main page, then that means there's a problem with the web service running on the machine.

If you can reach the main page, but can't access the database (the OI or the search pages), then the web server is running but either the database is down, the middleware is down, or one of the connections between the three is broken. The middleware (software that passes data from the web server to the database and back) in our instance is django.

Approval workflow for the new site

[Issue is not reserved]

1. Indexer makes change and submits.

[Issue reserved to Indexer and appears in Pending queue.]

2. Editor assigns a submitted change to himself for review.

[Issue still reserved to Indexer, but also in Assigned state.]

2. Indexer and Editor may go back and forth discussing, Indexer may make additional changes.

[Issue still reserved to Indexer but may be in either Pending or Assigned state.]

3. Editor either approves the change if Indexer has made appropriate changes, OR rejects the change if Indexer has refused.

[Issue changes are *live* on site if approved, OR are discarded if rejected.]


NOTE: If you, in the role of Editor, just want to comment on the change in a way that is visible in the change history but doesn't show up on the index page, there *is* a field for that that does *not* require assigning the issue to yourself. Only fields that display in the index page require approval, such as the regular Notes field.


Variant Issues

A link to the page detailing how to handle Variant Issues.

Error Tracker

Dealing with the Error List

List of Editors

Current and past list of editors

GCD Cheat Sheet

Formatted version of the GCD Cheat Sheet


Style Guide

Working document Style Guide

Information Storage

Information Storage Page - a place to put information for preservation

Unreleased Series Reservations

Reservations for series that have yet to be released

Last version before going to non-lasso site
Retained for historical purposes only.

Retrieved from "https://docs.comics.org/index.php?title=Editor_wiki&oldid=10256"