[ *** P52 Help: Add/Edit Guidelines *** ]
Posted: Wed Aug 20, 2014 1:05 pm
Guidelines for adding and editing to Portfolio52 (the playing card database)
NOTICE - This is now outdated and has been (in the process of) being replaced by an entry in the Learning section of Portfolio52.
Instead, this thread will remain for continued best practices discussions. Any input into the guidelines and updates for the guide to match the latest version of P52 are welcome.
TLWR (Too Long Won't Read) - SEARCH WELL FIRST. Only add ACTUAL decks that are fully qualified playing card decks (no coins, add ons, general card games, etc). Add ALL related information for ALL the fields, and do so accurately. Only add decks that you actually have in your possession and can provide quality scanned actual images of the decks (no photos, screen grabs, downloads). See details be low as needed. If you want to be an editor then sorry there is no TLDR option, read the following.
Notice - These guidelines are not yet updated for new fields/options) from the new system provided on October 14, 2016
Taking off of montecarlojoe's naming convention, I thought it would be good to start drafting contribution and editing guidelines until rhu gets a chance to incorporate them into the application. This will be a good way to flush out the details ahead of time as well. Any additions or changes respond below and myself or rhu can keep this first entry updated. It is absolutely critical that we all work together and follow these guidelines, please DO NOT start modifying the established conventions, but do propose changes if you feel they are needed.
Please also refer to the 'PlayingCardDB FAQs' thread for additional details
WHAT NOT TO ADD
* Do NOT add decks in concept, planning, funding or still in production. Wait until they have been delivered
* Do NOT add card games that do not also function as a standard deck (has numbered cards, courts, suits, etc). Exceptions can be made for card games that also are a full deck, alternate or additional suits, alternate indices, using numbers instead of JKQ, or of course alternate conventions worldwide, etc. For example, do not add Uno, Hanabi or Cards Against Humanity , but a card game like Wizard would work because it can also easily be identified as a standard deck for use in other standard card games.
* Tarot decks fall into a grey area and can be added if a member feels strongly about it being included, although that is not the primary goal of the database. If added please prefix title with 'TAROT DECK - ' for clarity until a new type field can be added as a selection.
* Do NOT add coins, shirts or any other add on from a card related Kickstarter project or theme. This includes custom wood boxes UNLESS it serves as the ONLY tuckbox (as a full tuck swap) and was fully packaged and sold as a set vs an add-on.
WHAT TO ADD / HOW TO ADD A NEW DECK
* If you don't have a quality scanner, at least use the Google PhotoScan app for your phone. If you don't want to take the time to use a properly captured and rotated/cropped image, please do not add the deck, especially if it is a new modern deck. In the current version of Portfolio52 only editors can modify images which means by adding an incomplete deck the vast majority of users can not correct it and are locked from adding their own better version.
* First be certain the deck isn't already added - both search and also check under ALL of the possible categories/producers/brands listings (to account for misspellings). NOTE - Do NOT add a new brand unless there are at least 5 decks to be listed under that new grand, otherwise use the Unknown, Kickstarter Misc, Casino Misc or other appropriate catch all groupings.
* Provided you have at least Contributor level access, new decks are added from the Add Deck' URL - http://www.portfolio52.com/deck/add (which is also now a drop down menu option). Once on that form be certain to fill out ALL the fields you can, make sure to add all images, especially tuck front/back AND the new mfg, brand, production company and artist fields if known and if available in the lists. While you can modify existing decks you created, it's best to get it all right immediately, especially since only you or editors can make corrections later (other general users or other contributors can not - new in P52, this includes ability to add additional images to decks contributors did not create themselves).
* To add an uncut sheet, at the moment add it as an individual entry with 'UNCUT' at the end of the name'
* Tuck swaps should be listed as separated entries
* Seal swaps, those decks that have a limited edition primarily due to a custom and usually serial numbered sticker/seal can also be added as separate entries. However, all decks within that seal are listed together (if it was a small run of 5, do not list each individual deck as separate entries).
NAMING A NEW DECK
* Naming convention - use this naming convention for consistency (see section below for details) : {NAME} {SUBTITLE(S)} {[BRAND]} {(CLARIFICATIONS)} {UNCUT}
NAMING A NEW DECK - DETAILS
* NAME: list the actual title of the deck as provided on the tuck or designated by the producer, listing any article word (as in 'The' or 'A') after the name with a comma as shown
* SUBTITLES: If applicable, include any other subtitles to help specify and differentiate it from other similar ones in the series. Consider listing the Version (recommend using v1, v2), Color, Limited Edition (if so called out by name), Date, etc as needed While the order is not critical, only list items essential and provided by the producer. If possible list from general to specific (version usually first) and be consistent with other decks in the series and by the same producer if possible.
* BRAND: If the deck is branded (as Bicycle for example) then list it as such in brackets "[]", otherwise do not use. Note this is not often required on an uncut sheet as typically only the tuckbox is branded.
* CLARIFICATIONS: ONLY if it is critical for differentiation or in searches, place within parenthesis "()" any other common clarification or alternate names not listed on the deck or by the producer. For example, Pandamonium also goes by Panda or to designate 'misprint', 'Limited Edition' (if not part of the deck title - for example if implied only by special color or seal) or any other common difference.
* UNCUT: List if it is an uncut sheet, otherwise do not use
* Only use these name components if essential and especially note that DATE should only be used if it was produced multiple years and need to distinguish printed year.
* Examples:
PROVIDING A DESCRIPTION
Tip - The text input box for the description is resizable to make it easier to work with, click/drag the bottom right corner to resize.
* While not essential, adding a description can be valuable to collectors, especially in the future as details of the deck are forgotten.
* Anything relevant about the deck, illustrator, manufacturer, stock, crowd funding details, URLs, etc can and should be included. This is a great place to document information about the deck for which there are not yet any custom fields for it.
* The structure of description content can be free form and vary, but below is a possible template to use if you desire:
Example:
* ONLY document the year, details about an exact date or time should be listed in the description if desired
* To minimize future confusion, the primary source is the copyright year printed on the deck if it exists, even if that was a copyright in the prior and it was printed early the next year. Use the description field to address these dependencies and further details as needed. If a date is not on the box then using any other source information available on when it actually was printed is the next best option.
* For a commercial deck that is available for immediate sale the date/year it is made available for purchase obviously should be utilized
* For a crowd funded deck (eg. Kickstarter), the date/year used should be when the deck was confirmed as printed, even if some backers have not yet received their rewards.
* If the exact year is not known, common for vintage decks, substitute 'X' as needed. For example, a deck known to be printed sometime in the 1960s could be listed as '196X'.
* Replica/Facsimile decks can list BOTH the date when the copy was printed AND the date of the deck it is a copy of. This can be done in the format of '<original date> <copy date>'. For example, '1804 2004'. This should be reserved for exact or near replicas, not inspired by decks.
PRINTED
* Please note this is the QUANTITY printed and not another request for a date
* Only complete if this can be confirmed, otherwise leave empty. Sources include numbered seals on the deck, producer/manufacturer documentation, Kickstarter details, etc
IMAGE GUIDELINES
* Personally scanned good quality (semi-high DPI) images are preferred, avoid early production (Kickstarter) images if possible since early renders often change before the final printing. Exception can be made to utilize renders for uncuts due to difficulty scanning or capturing a quality squared photo.
* Stock photos from the producer are usually acceptable, but when using those found on the internet do NOT use any copyrighted images. Sparkz on UC is a member and has added his photos and they use Creative Commons (http://www.sparkzcollector.com/#!image-usage/c22j7) so those will be seen on the site with watermarks, but don't assume any image on the Internet is free to use. Again, personally scanned or photographed are best when possible and when using images that have clearance for non-commercial use read the details and do NOT remove any watermarks.
* Using Photographs instead of scanned - Use the Google PhotoScan app if this is your only option due to lack of scanner or available images, it's also often the best option for uncuts. If that is not an option, please wait and allow others to add the deck instead, unless it's a VERY rare or unusual deck and stock images are not available.
* Replacing the SAME image with a better version is always encouraged.
* When selecting what image to be the thumb for a deck, when possible choose the image of just the tuckbox face.
* When selecting what image to be the thumb for an uncut, when possible choose a straight on view of the full uncut sheet without any mat/frame (camera photo or early proof images work best as source).
* The application will resize to apx tuckbox face dimensions within grouped views, but will display proper dimensions when viewed inside an entry or directly.
NEW PORTFOLIO52 FIELDS -
* The change to v2 (Portfolio52) added new fields for artist, brand, manufacturer in addition to previous company, DO NOT FORGET TO ALWAYS POPULATE THESE WHEN YOU CAN!
- Artists: person(s) that created the actual artwork)
- Brand: the commercial brand applied to some decks, usually Bicycle, Bee, Tally Ho, etc)
- Manufacturer: the actual printer of the deck, although sometimes the company behind an unamed printer, like EPCC)
- Company (aka producer, the person(s) or company(s) that had the vision and saw the idea complete to creation)
* If you need a new drop down entry added for any of these, see this thread
EDITING AN EXISTING DECK
* Use all related guidelines as listed in ADDING section
DELETING/MERGING EXISTING DECK(S)
* If you are an editor you may mark it yourself by first renaming the deck as 'DELETE - DUPLICATE' to avoid it coming up in other searches and for proper future identification. Next, in the description update it to state that it a duplicate of another deck and LINK to that deck so the creator and others that may have added to their collection know what it's a duplicate of (remember we renamed it). Lastly, to call attention to this for people that have it in their collection, replace the tuck scans with this image
* If you don't have edit access, you can post your duplicate find in this thread with the links to the 2 decks in question to allow for any discussion as they may have differences and not actually be duplicates. This also lets people be aware of a future merge/deletion.
* On occasion, and after sufficient time as passed for people to be made aware of the pending deletions, these marked duplicates/deletes will be fully removed.
NOTICE - This is now outdated and has been (in the process of) being replaced by an entry in the Learning section of Portfolio52.
Instead, this thread will remain for continued best practices discussions. Any input into the guidelines and updates for the guide to match the latest version of P52 are welcome.
TLWR (Too Long Won't Read) - SEARCH WELL FIRST. Only add ACTUAL decks that are fully qualified playing card decks (no coins, add ons, general card games, etc). Add ALL related information for ALL the fields, and do so accurately. Only add decks that you actually have in your possession and can provide quality scanned actual images of the decks (no photos, screen grabs, downloads). See details be low as needed. If you want to be an editor then sorry there is no TLDR option, read the following.
Notice - These guidelines are not yet updated for new fields/options) from the new system provided on October 14, 2016
Taking off of montecarlojoe's naming convention, I thought it would be good to start drafting contribution and editing guidelines until rhu gets a chance to incorporate them into the application. This will be a good way to flush out the details ahead of time as well. Any additions or changes respond below and myself or rhu can keep this first entry updated. It is absolutely critical that we all work together and follow these guidelines, please DO NOT start modifying the established conventions, but do propose changes if you feel they are needed.
Please also refer to the 'PlayingCardDB FAQs' thread for additional details
WHAT NOT TO ADD
* Do NOT add decks in concept, planning, funding or still in production. Wait until they have been delivered
* Do NOT add card games that do not also function as a standard deck (has numbered cards, courts, suits, etc). Exceptions can be made for card games that also are a full deck, alternate or additional suits, alternate indices, using numbers instead of JKQ, or of course alternate conventions worldwide, etc. For example, do not add Uno, Hanabi or Cards Against Humanity , but a card game like Wizard would work because it can also easily be identified as a standard deck for use in other standard card games.
* Tarot decks fall into a grey area and can be added if a member feels strongly about it being included, although that is not the primary goal of the database. If added please prefix title with 'TAROT DECK - ' for clarity until a new type field can be added as a selection.
* Do NOT add coins, shirts or any other add on from a card related Kickstarter project or theme. This includes custom wood boxes UNLESS it serves as the ONLY tuckbox (as a full tuck swap) and was fully packaged and sold as a set vs an add-on.
WHAT TO ADD / HOW TO ADD A NEW DECK
* If you don't have a quality scanner, at least use the Google PhotoScan app for your phone. If you don't want to take the time to use a properly captured and rotated/cropped image, please do not add the deck, especially if it is a new modern deck. In the current version of Portfolio52 only editors can modify images which means by adding an incomplete deck the vast majority of users can not correct it and are locked from adding their own better version.
* First be certain the deck isn't already added - both search and also check under ALL of the possible categories/producers/brands listings (to account for misspellings). NOTE - Do NOT add a new brand unless there are at least 5 decks to be listed under that new grand, otherwise use the Unknown, Kickstarter Misc, Casino Misc or other appropriate catch all groupings.
* Provided you have at least Contributor level access, new decks are added from the Add Deck' URL - http://www.portfolio52.com/deck/add (which is also now a drop down menu option). Once on that form be certain to fill out ALL the fields you can, make sure to add all images, especially tuck front/back AND the new mfg, brand, production company and artist fields if known and if available in the lists. While you can modify existing decks you created, it's best to get it all right immediately, especially since only you or editors can make corrections later (other general users or other contributors can not - new in P52, this includes ability to add additional images to decks contributors did not create themselves).
* To add an uncut sheet, at the moment add it as an individual entry with 'UNCUT' at the end of the name'
* Tuck swaps should be listed as separated entries
* Seal swaps, those decks that have a limited edition primarily due to a custom and usually serial numbered sticker/seal can also be added as separate entries. However, all decks within that seal are listed together (if it was a small run of 5, do not list each individual deck as separate entries).
NAMING A NEW DECK
* Naming convention - use this naming convention for consistency (see section below for details) : {NAME} {SUBTITLE(S)} {[BRAND]} {(CLARIFICATIONS)} {UNCUT}
NAMING A NEW DECK - DETAILS
* NAME: list the actual title of the deck as provided on the tuck or designated by the producer, listing any article word (as in 'The' or 'A') after the name with a comma as shown
* SUBTITLES: If applicable, include any other subtitles to help specify and differentiate it from other similar ones in the series. Consider listing the Version (recommend using v1, v2), Color, Limited Edition (if so called out by name), Date, etc as needed While the order is not critical, only list items essential and provided by the producer. If possible list from general to specific (version usually first) and be consistent with other decks in the series and by the same producer if possible.
* BRAND: If the deck is branded (as Bicycle for example) then list it as such in brackets "[]", otherwise do not use. Note this is not often required on an uncut sheet as typically only the tuckbox is branded.
* CLARIFICATIONS: ONLY if it is critical for differentiation or in searches, place within parenthesis "()" any other common clarification or alternate names not listed on the deck or by the producer. For example, Pandamonium also goes by Panda or to designate 'misprint', 'Limited Edition' (if not part of the deck title - for example if implied only by special color or seal) or any other common difference.
* UNCUT: List if it is an uncut sheet, otherwise do not use
* Only use these name components if essential and especially note that DATE should only be used if it was produced multiple years and need to distinguish printed year.
* Examples:
NOTE - Remember that you can rename your entry of a deck within your collection if you prefer something different than how it was originally added to the databasePersian Empire, The
Federal 52 [Bicycle]
Federal 52
Artifice V1 (2011)
Curator UNCUT
Persian Empire, The UNCUT
Civil War Red [Bicycle]
Civil War Blue [Bicycle]
Old Masters Limited Edition [Bicycle]
Hotcakes Black (Limited Edition)
PROVIDING A DESCRIPTION
Tip - The text input box for the description is resizable to make it easier to work with, click/drag the bottom right corner to resize.
* While not essential, adding a description can be valuable to collectors, especially in the future as details of the deck are forgotten.
* Anything relevant about the deck, illustrator, manufacturer, stock, crowd funding details, URLs, etc can and should be included. This is a great place to document information about the deck for which there are not yet any custom fields for it.
* The structure of description content can be free form and vary, but below is a possible template to use if you desire:
Code: Select all
Funded as a Kickstarter project on <funded date> with <amount raised> pledged from <num backers> backers, this was a <single/multiple/etc deck set>. Designed by <artist> through <company>, this deck features the theme of <theme described>. <additional information - printer, stock, awards, etc>. This PCDB Entry is for the <x deck, if multiples in the project>.
<Kickstarter URL>
DETERMINING THE RELEASE DATEFunded as a Kickstarter project on April 10, 2014 with $116,525 pledged from 1,394 backers, this was a set of two decks (Continental & The Crown) in three variations (Standard, Limited, Display) for a total of 6 decks. Designed by Jackson Robinson through Kings Wild Project, this deck features the theme of the United States struggle for independence against Britan. This PCDB Entry is for the Continental Display Deck which was the same cards as the Limited version, but with a plain style tuck case so collectors could feel free to use this deck and keep the actual Limited deck safe.
https://www.kickstarter.com/projects/17 ... by-the-rev" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;
The Independence decks also won the Best Ace of Spades award from UnitedCardists 2014 Deck of the Year
http://unitedcardists.com/viewtopic.php?f=8&t=6448" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;" onclick="window.open(this.href);return false;
* ONLY document the year, details about an exact date or time should be listed in the description if desired
* To minimize future confusion, the primary source is the copyright year printed on the deck if it exists, even if that was a copyright in the prior and it was printed early the next year. Use the description field to address these dependencies and further details as needed. If a date is not on the box then using any other source information available on when it actually was printed is the next best option.
* For a commercial deck that is available for immediate sale the date/year it is made available for purchase obviously should be utilized
* For a crowd funded deck (eg. Kickstarter), the date/year used should be when the deck was confirmed as printed, even if some backers have not yet received their rewards.
* If the exact year is not known, common for vintage decks, substitute 'X' as needed. For example, a deck known to be printed sometime in the 1960s could be listed as '196X'.
* Replica/Facsimile decks can list BOTH the date when the copy was printed AND the date of the deck it is a copy of. This can be done in the format of '<original date> <copy date>'. For example, '1804 2004'. This should be reserved for exact or near replicas, not inspired by decks.
PRINTED
* Please note this is the QUANTITY printed and not another request for a date
* Only complete if this can be confirmed, otherwise leave empty. Sources include numbered seals on the deck, producer/manufacturer documentation, Kickstarter details, etc
IMAGE GUIDELINES
* Personally scanned good quality (semi-high DPI) images are preferred, avoid early production (Kickstarter) images if possible since early renders often change before the final printing. Exception can be made to utilize renders for uncuts due to difficulty scanning or capturing a quality squared photo.
* Stock photos from the producer are usually acceptable, but when using those found on the internet do NOT use any copyrighted images. Sparkz on UC is a member and has added his photos and they use Creative Commons (http://www.sparkzcollector.com/#!image-usage/c22j7) so those will be seen on the site with watermarks, but don't assume any image on the Internet is free to use. Again, personally scanned or photographed are best when possible and when using images that have clearance for non-commercial use read the details and do NOT remove any watermarks.
* Using Photographs instead of scanned - Use the Google PhotoScan app if this is your only option due to lack of scanner or available images, it's also often the best option for uncuts. If that is not an option, please wait and allow others to add the deck instead, unless it's a VERY rare or unusual deck and stock images are not available.
* Replacing the SAME image with a better version is always encouraged.
* When selecting what image to be the thumb for a deck, when possible choose the image of just the tuckbox face.
* When selecting what image to be the thumb for an uncut, when possible choose a straight on view of the full uncut sheet without any mat/frame (camera photo or early proof images work best as source).
* The application will resize to apx tuckbox face dimensions within grouped views, but will display proper dimensions when viewed inside an entry or directly.
NEW PORTFOLIO52 FIELDS -
* The change to v2 (Portfolio52) added new fields for artist, brand, manufacturer in addition to previous company, DO NOT FORGET TO ALWAYS POPULATE THESE WHEN YOU CAN!
- Artists: person(s) that created the actual artwork)
- Brand: the commercial brand applied to some decks, usually Bicycle, Bee, Tally Ho, etc)
- Manufacturer: the actual printer of the deck, although sometimes the company behind an unamed printer, like EPCC)
- Company (aka producer, the person(s) or company(s) that had the vision and saw the idea complete to creation)
* If you need a new drop down entry added for any of these, see this thread
EDITING AN EXISTING DECK
* Use all related guidelines as listed in ADDING section
DELETING/MERGING EXISTING DECK(S)
* If you are an editor you may mark it yourself by first renaming the deck as 'DELETE - DUPLICATE' to avoid it coming up in other searches and for proper future identification. Next, in the description update it to state that it a duplicate of another deck and LINK to that deck so the creator and others that may have added to their collection know what it's a duplicate of (remember we renamed it). Lastly, to call attention to this for people that have it in their collection, replace the tuck scans with this image
* If you don't have edit access, you can post your duplicate find in this thread with the links to the 2 decks in question to allow for any discussion as they may have differences and not actually be duplicates. This also lets people be aware of a future merge/deletion.
* On occasion, and after sufficient time as passed for people to be made aware of the pending deletions, these marked duplicates/deletes will be fully removed.