Formatting Documentation

From GCD
Revision as of 11:25, 9 January 2010 by Bookcats (talk | contribs) (update Grand Comic-Book to Grand Comics as per charter change)
Jump to navigation Jump to search

The Formatting Documents are a set of the top-most documents in the hierarchy of documents about The Grand Comics Database. If anything written anywhere else contradicts this document, the Formatting Documents are deemed to have the correct information. (And please let us know if you do find any contradictions). The documentation for formatting has had a long history of being neglected to be updated when decisions have been made, so there are many records in the database that will not match these Documents. The Editors are working on correcting the records, but it is a slow process.

The Formatting Documents are written to provide indexers, editors and tech people a common language on what should be entered into the database, where it should be entered and how it should be entered. As such, they apply to both the Online Interface (OI) and the Flat-File format.

NOTE: The current Format Document had not been updated since 1999. It is available via the Wayback Machine. The pages linked to here are a re-write some of which has been approved by the Senior Editors, some of which is generally accepted but not officially approved.

General Indexing Format Rules

  • Credits that are not applicable to the story in question (colorist for black & white stories, writer or letterer for pinups) should have the No checkbox checked (previously we entered "none" in the field)
  • Fields where information is required but not known should not be left blank, but should be filled with "?" unless there is an "uncertain" checkbox like "Page count uncertain"
  • Multiple entries in the same field (such as stories with more than one penciller) should be separated with a semi-colon (";") not a comma.
  • Square brackets are used for "also known as" or other information that is not in the actual comic, such as ("[as Joe King] ").
  • Round brackets are used for further detail, such as describing a contributors exact contribution ("(co-plotter)") or information about a character ("(introduction)").

Fields available to Indexers

1.0: Edit Issue Fields Screen

 1.1: Issue (unapproved)
 1.2: Volume (approved)
 1.3: Indicia publisher (unapproved)
 1.4: Brand (unapproved)
 1.5: Publication Date (approved)
 1.6: Keydate (approved)
 1.7: Indicia frequency (unapproved)
 1.8: Price (approved)
 1.9: Page Count (approved)
 1.10: Editing (unapproved)
 1.11: Notes (issue) (unapproved)
 1.12: Comments

2.0: Sequence/Story Screen

 2.1: Sequence Number (approved)
 2.2: Title (approved)
 2.3: Type (unapproved)
 2.4: Feature (unapproved)
 2.5: Page Count (approved)
 2.6: Credits (approved)
  2.6.1: Script (unapproved)
  2.6.2: Pencils (unapproved)
  2.6.3: Inks (unapproved)
  2.6.4: Colors (unapproved)
  2.6.5: Letters (unapproved)
  2.6.6: Editing (unapproved)
 2.7: Genre (unapproved)
 2.8: Character Appearances (unapproved)
 2.9: Job Number (approved)
 2.10: Reprint Notes (partially approved)
 2.11: Synopsis (unapproved)
 2.12: Notes (unapproved)
 2.13: Comments (unapproved)

3.0: Series (all unapproved)

3.1: Book Name
3.2: Format
3.3: Years of Publication
3.4: Series Notes
3.5: Tracking
3.6: Country Code
3.7: Language Code
3.8: Publisher Notes
3.9: Publication Dates - no longer used?
3.10: Issue Range - no longer used?
3.11: Imprint - not accessible from this screen
3.12: Comments

4.0: Issues (all unapproved)

4.1: Issue Numbers
4.2: Cover SortCode (StickyScan)

5.0: Publisher (all unapproved)

5.1: Publisher Name
5.2: Years of Operation
5.3: Country
5.4: URL
5.5: Notes (on Publisher Screen)
5.6: Comments

6.0: Brand (all unapproved)

6.1: Brand Name
6.2: Years of Use (Brand)
6.3: URL (Brand)
6.4: Notes (Brand)
6.5: Comments

7.0: Indicia Publisher (all unapproved)

7.1: Indicia Name
7.2: Years of Use (Indicia publisher)
7.3: Surrogate
7.4: Country (Indicia publisher)
7.5: URL (Indicia publisher)
7.6: Notes (Indicia publisher)
7.7: Comments