Indexing: Difference between revisions

From GCD
Jump to navigation Jump to search
(Undo spam revision 2080 by JamesCowan (Talk))
Line 6: Line 6:
'''Important Note:'''  Contributors cannot copy existing, published indexes without the permission of the copyright holder. Copyright laws and good manners prohibit such actions. If you have obtained permission, you must note the source of the material in your index. Cover scans from other sources (web sites or compilation CD's) are not allowed unless you have obtained their permission. Cover scans with watermarks are never allowed.  All efforts should be made to scan your own covers.  Check with [mailto:[email protected] gcd-main] if in doubt.
'''Important Note:'''  Contributors cannot copy existing, published indexes without the permission of the copyright holder. Copyright laws and good manners prohibit such actions. If you have obtained permission, you must note the source of the material in your index. Cover scans from other sources (web sites or compilation CD's) are not allowed unless you have obtained their permission. Cover scans with watermarks are never allowed.  All efforts should be made to scan your own covers.  Check with [mailto:[email protected] gcd-main] if in doubt.


Indexing is done through our Online Indexing system of web forms by logging in through the front page or the login link on the search bar on each page.  An older method, known as [[Indexing Offline|Offline Indexing]], involved text files (a.k.a. "Flat Files") and is not currently supported.
Indexing is done through our Online Indexing system of web forms by logging in through the front page or the login link on the search bar on each page.  An alternative method, known as [[Indexing Offline|Offline Indexing]], involves uploading text files (a.k.a. "Flat Files") in place of using the web forms.


==What makes an index "complete"?==
==What makes an index "complete"?==

Revision as of 07:08, 9 December 2010

Introduction to Indexing

Indexing is the primary way of contributing data to the GCD. For each comic, an full indexer records at minimum the issue's number, date, price and page count as well as the types, titles and credits for each story and cover. A wealth of additional information, including character appearances, genres and plot synopses, may optionally be entered.

Important Note: Contributors cannot copy existing, published indexes without the permission of the copyright holder. Copyright laws and good manners prohibit such actions. If you have obtained permission, you must note the source of the material in your index. Cover scans from other sources (web sites or compilation CD's) are not allowed unless you have obtained their permission. Cover scans with watermarks are never allowed. All efforts should be made to scan your own covers. Check with gcd-main if in doubt.

Indexing is done through our Online Indexing system of web forms by logging in through the front page or the login link on the search bar on each page. An alternative method, known as Offline Indexing, involves uploading text files (a.k.a. "Flat Files") in place of using the web forms.

What makes an index "complete"?

A "complete" index has, at minimum: Titles, page counts, credits (even if unknown) and features for each of the stories (either text or comic) and for the cover of the comic. It does not need to have letter pages, promos or ads, though these are definitely desirable. It also doesn't have to have characters, synopses or notes about reprints, though these are definitely desirable too. The more information, the better. Note: The exact definition of a minimal "complete" index is currently under discussion on gcd-policy.

Indexers are encouraged to contribute whatever information they can, as even incomplete indexes are valuable. Indexers may also fill in missing information on existing indexes. While we have a definition for "complete" indexes, that really only covers the basics. Indexes are rarely truly complete, as a fully-detailed cover-to-cover account of a comic is a lot of work!

How do I get started as an indexer?

First you need an Online Indexing account. There is a link on the front page to register [1] through the website.

GCD Account Creation.jpg (click to enlarge)

The information you will be asked to provide is:

  • Your email address. It will be used as your user name.
  • Your password
  • Your name that you would like to be credited by. Preferably your real name.
  • Your country
  • Your (current) e-mail address
  • The languages you read (multiple languages can be selected)
  • Your comic book interests (not necessary, but we like to know a bit about you so we can pair you up with an editor with similar interests if possible)

Do not use a sensitive password as the system is not designed for high security.

You will receive an email with how to confirm your account, and then you can start entering info into the database!

An alternate way of registering is to email the Account Admin with the above information.

How do I learn how to index?

The OI Tutorial will guide you through the basics. Since we have just switched to a new indexing system, they are very much a work in progress.

For more details (and the official rules on what should and shouldn't be entered in each field) the most up-to-date documentation is the Formatting Documentation on this wiki. There are some older documents outside this wiki that you might find if we haven't hunted down all the old links yet. In the event of a disagreement, the wiki wins :-)

How do I create my first index?

  • Log in at http://www.comics.org, using your Username/email and Password (see above).
  • If you want to index a comic, find out if the comic is available for indexing by searching the database.
  • If the issue you want to index is shown in white in the "Index Status Grid", then it should be available for you to make a reservation.
  • Reserve the issues you need by clicking through to them and clicking the "Edit" button.
  • Index the comic, following the directions in the OI Tutorial and Formatting Documentation. Then hit the "Submit Changes for Approval" button.
  • First time indexers will be contacted by one of the Editors at the GCD to be mentored and to help along with some of our more specific formatting. We require the data to be in one format so that it is easily searchable. Please don't be put off by some of the seemingly strange things we require to be done, once you've done it a couple of times it becomes old hat!

What happens after I submit my index?

After you submit the index, an editor will check the data for errors and proper formatting, and then approve the index (usually within a week). If there is a problem, the index may be put back in your queue with comments and you may be contacted by e-mail for comment. Your queue is accessible by clicking on the "Profile" link on the top and bottom search bars after you are logged in. (Minor errors, such as typos, may be fixed by the editor without contacting you.) Do not be discouraged if you get a list of stuff to be corrected back. The editors can be a picky bunch, and they have to be. We need the data in the database to be consistent for future uses and for searching. After the index has been approved, use the GCD search form at: http://www.comics.org/ and check your index to see if any errors got missed. If there are any errors, please re-reserve the comic and correct it yourself, or file an error report using the link that's on every page.

What are common errors for people's first indexes?

  • Mis-entering (or misunderstanding) the Keydate is common.
  • Not putting ?s on data which is not known is common.
    • All creator fields (except 'script' for covers and 'editor' for sequences other than the first cover) must have a name, "?" or have the "No Script" (for example) box checked.
  • Not using [] and () correctly.
    • [] is for alternate names, such as character secret identities, writer/artist pen names or studio names. Pen names are noted like this: [as Jane Doe] while character names do not use "as".
    • () is for explanatory notes, such as the fact that this is the introduction of a character, or that one artist credited for pencils drew only the first half of the book, while the other artist drew the second half.
    • [] is also generally used for information not present in the comic, such as a made-up story title.
  • Using unapproved genres. See the Official Genres List
  • Using commas instead of semi-colons to separate data.
  • Missing page counts for one or more sequences.
    • Don't forget to put the page count of the whole book in the Edit Issue Fields page and not the first cover record (as used to be done).

The details for this are covered on the Formatting Documentation page.

What's up with all these crazy rules anyway?

Currently most of the fields in the database are free-form text. In the future we will change this so that they are more structured, and then the system will handle a lot of the formatting automatically. For instance, right now you must put a semi-colon between multiple pencilers for a story, and that all gets stuffed in one field and displayed with the punctuation you used. In the future, each penciler will be a separate credit, and you will not need to worry about what sort of punctuation to put between them - the system will add it automatically. For now please bear with our rules as following them will help us move to an improved system more quickly!