Consumer Rights Wiki:Style guide: Difference between revisions
→Wikipedia: formatting |
|||
| (3 intermediate revisions by the same user not shown) | |||
| Line 41: | Line 41: | ||
*Use regional spelling conventions for region-specific topics | *Use regional spelling conventions for region-specific topics | ||
*Maintain consistent date and number formats throughout | *Maintain consistent date and number formats throughout | ||
===Quotations and punctuation=== | ===Quotations and punctuation=== | ||
| Line 85: | Line 86: | ||
The first appearance of an [[wikipedia:Initialism|initialisms]] and [[wikipedia:Acronym|acronyms]] must be spelled out, with the initialism in parentheses (if it is intended to be used in the rest of the article). For instance, do not write “DRM” in an article without having its first appearance in the article rendered as “digital-rights management (DRM)”. Link the expanded term (rather than the initialism) where possible. | The first appearance of an [[wikipedia:Initialism|initialisms]] and [[wikipedia:Acronym|acronyms]] must be spelled out, with the initialism in parentheses (if it is intended to be used in the rest of the article). For instance, do not write “DRM” in an article without having its first appearance in the article rendered as “digital-rights management (DRM)”. Link the expanded term (rather than the initialism) where possible. | ||
==Page links== | |||
When linking text in articles, only link the first instance within the article. For instance, on an article about a Sony product, do not link each appearance of the word “Sony”. | When linking text in articles, only link the first instance within the article. For instance, on an article about a Sony product, do not link each appearance of the word “Sony”. | ||
In general, | Aside from internal links, which should be used at the first mention of another article on the CRW within each article, there will also be times when it is suitable to include links to external sites directly within an article's text (as opposed to via a citation/reference). In general this should be kept to a minimum, however the main exceptions to this rule are described below: | ||
===Wikipedia=== | |||
A link should be made to Wikipedia when: | |||
* a significant entity is first mentioned in an article, which is not represented on the CRW, or; | |||
* an entity is first mentioned on its own page. | |||
Wikipedia links are used to provide additional context to the reader about entities or concepts involved in an article, where an internal CRW link could not provide such context. they may be used in place of internal CRW in-line links when such an internal link would lead to an empty page. Do not link stub Wikipedia articles, as these are unlikely to provide useful context to the reader. | |||
===iFixit=== | |||
At the first mention of the specific product model for an electrical device within an article, an external link should be made to its iFixit page (if extant), as iFixit tends to be the best source for specific model information, and can provide useful context to a reader. | |||
===Official company websites=== | |||
The official website of a company, product, or insitiution which is the subject of an article should generally only be linked in the article's infobox. Where the article does not contain an infobox, and there is no similar location to place the link, it may be inserted as a link in text. If a entity has an entity page on the CRW with a link in its infobox to the official company website, then the link at the first mention of the entity within the article should be to the company's CRW article, not to its website. | |||
==Citations and references== | ==Citations and references== | ||
| Line 135: | Line 150: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Field name !! Type !! Format/Validation !! Notes | !Field name!!Type!!Format/Validation!!Notes | ||
|- | |- | ||
| Founded || Date || YYYY-MM-DD || Month and day optional (YYYY or YYYY-MM also valid) | |Founded||Date||YYYY-MM-DD||Month and day optional (YYYY or YYYY-MM also valid) | ||
|- | |- | ||
| Industry || List of String || Comma-separated || Multiple industries allowed; use existing values when possible | |Industry||List of String||Comma-separated||Multiple industries allowed; use existing values when possible | ||
|- | |- | ||
| Logo || File || PNG/JPG || Upload functionality requires Chromium-based browsers | |Logo||File||PNG/JPG||Upload functionality requires Chromium-based browsers | ||
|- | |- | ||
| ParentCompany || Page || Wiki page name || Links to another Company page; can enter non-existent companies | |ParentCompany||Page||Wiki page name||Links to another Company page; can enter non-existent companies | ||
|- | |- | ||
| Type || String || Single value || Legal structure: Public, Private, Non-Profit, Government | |Type||String||Single value||Legal structure: Public, Private, Non-Profit, Government | ||
|- | |- | ||
| Website || List of URL || Comma-separated || Only separate TLDs or regional variations | |Website||List of URL||Comma-separated||Only separate TLDs or regional variations | ||
|- | |- | ||
| Description || String || 150 characters max || Brief company description | |Description||String||150 characters max||Brief company description | ||
|} | |} | ||
| Line 156: | Line 171: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Field name !! Type !! Format/Validation !! Notes | !Field name!!Type!!Format/Validation!!Notes | ||
|- | |- | ||
| Company || List of Page || Comma-separated || Links to Company pages | |Company||List of Page||Comma-separated||Links to Company pages | ||
|- | |- | ||
| ReleaseYear || Date || YYYY || Four-digit year only | |ReleaseYear||Date||YYYY||Four-digit year only | ||
|- | |- | ||
| InProduction || Boolean || Checkbox || Whether currently in production | |InProduction||Boolean||Checkbox||Whether currently in production | ||
|- | |- | ||
| ArticleType || String || Product/Service || Specifies type of offering | |ArticleType||String||Product/Service||Specifies type of offering | ||
|- | |- | ||
| Category || List of String || Comma-separated || Product categories (e.g., Laptop, Desktop, Server) | |Category||List of String||Comma-separated||Product categories (e.g., Laptop, Desktop, Server) | ||
|- | |- | ||
| Logo || File || PNG/JPG || Upload functionality requires Chromium-based browsers | |Logo||File||PNG/JPG||Upload functionality requires Chromium-based browsers | ||
|- | |- | ||
| Website || List of URL || Comma-separated || Only separate TLDs or regional variations | |Website||List of URL||Comma-separated||Only separate TLDs or regional variations | ||
|- | |- | ||
| Description || String || 150 characters max || Brief product line description | |Description||String||150 characters max||Brief product line description | ||
|} | |} | ||
| Line 179: | Line 194: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Field name !! Type !! Format/Validation !! Notes | !Field name!!Type!!Format/Validation!!Notes | ||
|- | |- | ||
| Company || List of Page || Comma-separated || Links to Company pages | |Company||List of Page||Comma-separated||Links to Company pages | ||
|- | |- | ||
| ProductLine || List of Page || Comma-separated || Links to ProductLine pages; existing values only | |ProductLine||List of Page||Comma-separated||Links to ProductLine pages; existing values only | ||
|- | |- | ||
| ReleaseYear || Date || YYYY || Four-digit year only | |ReleaseYear||Date||YYYY||Four-digit year only | ||
|- | |- | ||
| InProduction || Boolean || Checkbox || Whether currently in production | |InProduction||Boolean||Checkbox||Whether currently in production | ||
|- | |- | ||
| ArticleType || String || Product/Service || Specifies type of offering | |ArticleType||String||Product/Service||Specifies type of offering | ||
|- | |- | ||
| Category || List of String || Comma-separated || Product categories | |Category||List of String||Comma-separated||Product categories | ||
|- | |- | ||
| Logo || File || PNG/JPG || Upload functionality requires Chromium-based browsers | |Logo||File||PNG/JPG||Upload functionality requires Chromium-based browsers | ||
|- | |- | ||
| Website || List of URL || Comma-separated || Only separate TLDs or regional variations | |Website||List of URL||Comma-separated||Only separate TLDs or regional variations | ||
|- | |- | ||
| Description || String || 150 characters max || Brief product description | |Description||String||150 characters max||Brief product description | ||
|} | |} | ||
| Line 204: | Line 219: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Field name !! Type !! Format/Validation !! Notes | !Field name!!Type!!Format/Validation!!Notes | ||
|- | |- | ||
| Company || List of Page || Comma-separated || Links to Company pages | |Company||List of Page||Comma-separated||Links to Company pages | ||
|- | |- | ||
| StartDate || Date || YYYY-MM-DD || Month and day optional | |StartDate||Date||YYYY-MM-DD||Month and day optional | ||
|- | |- | ||
| EndDate || Date || YYYY-MM-DD || Month and day optional; leave blank if ongoing | |EndDate||Date||YYYY-MM-DD||Month and day optional; leave blank if ongoing | ||
|- | |- | ||
| Status || String || Dropdown || Active, Pending Resolution, or Resolved | |Status||String||Dropdown||Active, Pending Resolution, or Resolved | ||
|- | |- | ||
| ProductLine || List of Page || Comma-separated || Links to ProductLine pages; existing values only | |ProductLine||List of Page||Comma-separated||Links to ProductLine pages; existing values only | ||
|- | |- | ||
| Product || List of Page || Comma-separated || Links to Product pages; existing values only | |Product||List of Page||Comma-separated||Links to Product pages; existing values only | ||
|- | |- | ||
| ArticleType || String || Product/Service || Specifies what the incident relates to | |ArticleType||String||Product/Service||Specifies what the incident relates to | ||
|- | |- | ||
| Type || List of String || Comma-separated || Incident types (e.g., Repairability, Privacy) | |Type||List of String||Comma-separated||Incident types (e.g., Repairability, Privacy) | ||
|- | |- | ||
| Description || String || 150 characters max || Brief incident description | |Description||String||150 characters max||Brief incident description | ||
|} | |} | ||
| Line 262: | Line 277: | ||
}} | }} | ||
</nowiki> | </nowiki> | ||
[[Category:CRW]] | [[Category:CRW]] | ||