Formatting Documentation: Difference between revisions

From GCD
Jump to navigation Jump to search
(update Grand Comic-Book to Grand Comics as per charter change)
(Removed all "approved"/"unapproved" markings per discussions on gcd-policy.)
Line 1: Line 1:
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 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).  Older records in the database may not match what is documented here.  The Editors are working on correcting the records, but it is a slow process.  These rules are currently being reviewed and updated on the [http://groups.google.com/group/gcd-policy gcd-policy] mailing list.  Please feel free to join if you are interested in the discussions.


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.
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 1999It is available via [http://web.archive.org/web/20070607205521/www.comics.org/format/format.html 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.
'''Note''': You may see notes about a rule being "approved" or "unapproved" or "under consideration by the Sr. Editors"These notes are from an earlier project and should be disregardedWe are in the process of removing them but you may still see some around.


== General Indexing Format Rules ==
== General Indexing Format Rules ==
Line 15: Line 15:
== Fields available to Indexers ==
== Fields available to Indexers ==
1.0: Edit Issue Fields Screen
1.0: Edit Issue Fields Screen
   1.1: [[Issue Numbers|Issue]] (unapproved)
   1.1: [[Issue Numbers|Issue]]
   1.2: [[Volume]] (approved)
   1.2: [[Volume]]
   1.3: [[Indicia publisher]] (unapproved)
   1.3: [[Indicia publisher]]
   1.4: [[Brand]] (unapproved)
   1.4: [[Brand]]
   1.5: [[Published Date|Publication Date]] (approved)
   1.5: [[Published Date|Publication Date]]
   1.6: [[Keydate]] (approved)
   1.6: [[Keydate]]
   1.7: [[Indicia frequency]] (unapproved)
   1.7: [[Indicia frequency]]
   1.8: [[Cover Price|Price]] (approved)
   1.8: [[Cover Price|Price]]
   1.9: [[Page Count]] (approved)
   1.9: [[Page Count]]
   1.10: [[Editing]] (unapproved)
   1.10: [[Editing]]
   1.11: [[Notes (issue)]] (unapproved)
   1.11: [[Notes (issue)]]
   1.12: [[Comments]]
   1.12: [[Comments]]


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


3.0: Series (all unapproved)
3.0: Series
  3.1: [[Book Name]]
  3.1: [[Book Name]]
  3.2: [[Format]]
  3.2: [[Format]]
Line 58: Line 58:
  3.7: [[Language Code]]
  3.7: [[Language Code]]
  3.8: [[Publisher Notes]]
  3.8: [[Publisher Notes]]
  3.9: [[Publication Dates]] - no longer used?
  3.9: [[Publication Dates]] - no longer used
  3.10: [[Issue Range]] - no longer used?
  3.10: [[Issue Range]] - no longer used
  3.11: [[Imprint]] - not accessible from this screen
  3.11: [[Imprint]] - not accessible from this screen
  3.12: [[Comments]]
  3.12: [[Comments]]


4.0: Issues (all unapproved)
4.0: Issues
  4.1: [[Issue Numbers]]
  4.1: [[Issue Numbers]]
  4.2: [[Cover SortCode]] (StickyScan)
  4.2: [[Cover SortCode]] (StickyScan)


5.0: Publisher (all unapproved)
5.0: Publisher
  5.1: [[Publisher Name]]
  5.1: [[Publisher Name]]
  5.2: [[Years of Operation]]
  5.2: [[Years of Operation]]
Line 75: Line 75:
  5.6: [[Comments]]
  5.6: [[Comments]]


6.0: Brand (all unapproved)
6.0: Brand
  6.1: [[Brand|Brand Name]]
  6.1: [[Brand|Brand Name]]
  6.2: [[Years of Use (Brand)]]
  6.2: [[Years of Use (Brand)]]
Line 82: Line 82:
  6.5: [[Comments]]
  6.5: [[Comments]]


7.0: Indicia Publisher (all unapproved)
7.0: Indicia Publisher
  7.1: [[Indicia publisher|Indicia Name]]
  7.1: [[Indicia publisher|Indicia Name]]
  7.2: [[Years of Use (Indicia publisher)]]
  7.2: [[Years of Use (Indicia publisher)]]

Revision as of 07:06, 1 March 2010

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). Older records in the database may not match what is documented here. The Editors are working on correcting the records, but it is a slow process. These rules are currently being reviewed and updated on the gcd-policy mailing list. Please feel free to join if you are interested in the discussions.

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: You may see notes about a rule being "approved" or "unapproved" or "under consideration by the Sr. Editors". These notes are from an earlier project and should be disregarded. We are in the process of removing them but you may still see some around.

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
 1.2: Volume
 1.3: Indicia publisher
 1.4: Brand
 1.5: Publication Date
 1.6: Keydate
 1.7: Indicia frequency
 1.8: Price
 1.9: Page Count
 1.10: Editing
 1.11: Notes (issue)
 1.12: Comments

2.0: Sequence/Story Screen

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

3.0: Series

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

4.1: Issue Numbers
4.2: Cover SortCode (StickyScan)

5.0: Publisher

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

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

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