Editor wiki: Difference between revisions

From GCD
Jump to navigation Jump to search
(New page: Genre List (New Page added 12/21/2007). Excel list of all words or phrases used as genres Problem series that need to be worked on A somewhat accurate list of editors [[Tuto...)
 
m (→‎Becoming an Editor: bullet formatting)
 
(55 intermediate revisions by 12 users not shown)
Line 1: Line 1:
[[Genre List]] (New Page added 12/21/2007). Excel list of all words or phrases used as genres


[[Problem series]] that need to be worked on
==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.


A somewhat accurate [[list of editors]]
==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.


[[Tutorial]]
==Approving Covers==
[[Reviewing and Approving Covers]]


[[Glossary]] from 2003
==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.


How to do [[British Prices]] (from an old email of Jamal's)
===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.)


Towards an explanation of how the data is layed out in the [[current schema]]
==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.


Formatted version of the GCD [[Cheat Sheet]]
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.


Hints and guidelines for GCD editors!
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.


[[Information Storage]] Page - a place to put information for preservation
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.


Maybe when the guys get done with the format document we can have them work up an "editor" document based on the email Ralf sent awhile back that detailed a lot of stuff for new editors, and include tools like this. I know I'd like a "cheat sheet" to look at occasionally instead of digging thru old emails to find the hint I want.
==Approval workflow for the new site==
[Issue is not reserved]


Mike
1.  Indexer makes change and submits.


As these ideas come through the GCD editor list, they can be pasted here, then reassembled into a coherent document later. - Art
[Issue reserved to Indexer and appears in Pending queue.]


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.
2.  Editor assigns a submitted change to himself for review.


The following is the text of Ralf's famous "stuff for new editors" e-mail:
[Issue still reserved to Indexer, but also in Assigned state.]


Keep the two roles distinct in your mind. If you want to do "Indexer" type
2. Indexer and Editor may go back and forth discussing, Indexer may make additional changes.
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.


The Pending pane is pretty self explanatory, I think. You have the link to
[Issue still reserved to Indexer but may be in either Pending or Assigned state.]
the indexer's e-mail so you can easily let them know that there is
something wrong with their index. You have 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). You have an edit button which brings you
to the page to edit the content if need be. The checkboxes and the button
at the bottom of the page are how indexes should be approved. DO NOT
APPROVE BOOKS IN THE DATABASE PANE. DO NOT INDEX BOOKS IN THE DATABASE
PANE. Sorry to yell, but so many people seem to get that wrong.


In the Database pane, you'll see the different categories to search on. To
3. Editor either approves the change if Indexer has made appropriate changes, OR rejects the change if Indexer has refused.
create a series, you will need to 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
or Present 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.


To add issues to a series, search for the series and drill down into it.
[Issue changes are *live* on site if approved, OR are discarded if rejected.]
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. (VERY IMPORTANT, more later)


There are couple pages you can access by knowing the series ID that
appears in the url when you visit any series page. Some examples:
**Email an Editor directly for this link***


This is the keydate page, where you can see all the issues in a series and
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.
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.


**Email an Editor directly for this link***


This is the cover sort code page. Cover sorting is completely separate
==Variant Issues==
from issue sorting. If covers sort in the wrong order, it can be very
A link to the page detailing how to handle [[Variant Issues]].
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.


To fix series with odd covers, use the above stickyscan page. To change a
==Error Tracker==
cover sort code, you will need to:


a) save a copy of the large scan to your local hard drive
[[Error Tracker Workflow|Dealing with the Error List]]
b) go into the OI Database pane, bring up the issue and click the link
underneath the cover to delete the cover
c) go to the stickyscan page and change teh cover sort code
d) upload the cover that you saved in step a


Going back to the "add single issue" comments above where you need to
==List of Editors==
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.


Yes, covers are a pain.
Current and past [[list of editors]]


What else....
==GCD Cheat Sheet==


In the OI Database pane again, when viewing in issue you may see dropdown
Formatted version of the GCD [[Cheat Sheet]]
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.
Finally, and most importantly, when you fix something from the error list
remember to a) send a response e-mail so everyone will know it is fixed
and b) make sure that the response is going to the error list AND the
person who reported the error. "Reply All" doesn't always work depending
on the e-mail software you are using.


The easy way to fix keydates is via the link


**Email an Editor directly for this link***
==Style Guide==
Working document [[Style Guide]]


Just plug in the relevant series ID.
==Information Storage==
Sticky Scans can be fixed with via the link:


**Email an Editor directly for this link***
[[Information Storage]] Page - a place to put information for preservation
 
append the series id on the end of the link after the =. That is also true of the Keydate link right above this. Replace the '3857' with the series id you are working with.
 
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 Lasso.
 
[I was just deleting old emails and came across the following from October 2006... written by Robert Sharp and Jim Ludwig]
WHAT EVERY EDITOR NEEDS TO KNOW. Here is a start.
>
> 1) Never approve indexes from inside the database.
> Approve from the pending list only.
> 2) Always check the EDIT THIS ISSUE to make sure
> the keydate and other information is correct.
 
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.
 
> 3) Cover sequence includes the total page count for
> the entire issue.
 
Another point - 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.
 
> 4) 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.
5) 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.
 
Also see note 4 above.
 
Stories/features table:
If the numbering here is not consecutive, (or contains
duplicate numbers), then there is a problem.
 
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 Ad or
Promo


all Credits fields except Editor - with an exception
==Unreleased Series Reservations==
for minor Types like Ads & Promos?


6) Use the "Series info" link to compare the
[[Unreleased Series Reservations|Reservations for series that have yet to be released]]
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.


7) Check the cover scan (if present). On recent
-----
comics, the credits printed on the cover are a good
[http://docs.comics.org/w/index.php?title=Editor_wiki&oldid=605 Last version before going to non-lasso site]
way to "spell-check" the indexed credits.
<br>
Retained for historical purposes only.
8) 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).


9) Check that "Story" Type sequences are actually
[[Category: Editor Wiki]]
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.)

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"