Consumer Rights Wiki:Write your first article!: Difference between revisions

Kostas (talk | contribs)
m Update the add references section
add meta description
 
(34 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<span id="Creating an article"></span><!-- This prevents linking to the section of the same name below. Contributors need to read these first two paragraphs first, otherwise they risk doing a bunch of work all for nothing. -->
{{#seo:
|title=Write Your First Article - Consumer Rights Wiki
|description=Step-by-step guide for new Consumer Rights Wiki contributors. Covers minimum requirements, article structure, verifiable claims, and editorial standards.
|og:title=Write Your First Article - Consumer Rights Wiki
|og:description=Step-by-step guide for new Consumer Rights Wiki contributors. Covers minimum requirements, article structure, verifiable claims, and editorial standards.
|og:type=article
|keywords=consumer rights wiki, write article, contribute, getting started, new contributor, guide
}}
<!-- This prevents linking to the section of the same name below. Contributors need to read these first two paragraphs first, otherwise they risk doing a bunch of work all for nothing. -->
<!-- NB: Additions should only be about issues that can't be fixed in 5 minutes. Before adding to this article, consider that the longer it gets, the less users will read. -->
<!-- NB: Additions should only be about issues that can't be fixed in 5 minutes. Before adding to this article, consider that the longer it gets, the less users will read. -->
Welcome to the Consumer Action Taskforce! If you're reading this, you likely share our desire to see consumers treated more fairly. This article will help you to start documenting an instance of [[Mission_statement#What_is_%22new%22_consumer_protection?|"new" consumer exploitation]], so you can help us to further that cause.
Welcome to the Consumer Rights Wiki! If you're reading this, you likely share our desire to see consumers treated more fairly. This article will help you to start documenting an instance of [[Mission_statement#What_is_%22new%22_consumer_protection?|"new" consumer exploitation]], so you can help us to further that cause.


Before getting started, you need to know some of the requirements for a new article on this wiki. The [[Consumer_Action_Taskforce:CAT_policy_index|wiki policy]] covers all the guidelines that mature articles need to follow, but reading these guidelines from start to finish may be a daunting task for new contributors. The next section describes the minimum requirements in order to write an article that can be molded into complying with these guidelines in a reasonable amount of time.
Before getting started, you need to know some of the requirements for a new article on this wiki. The [[Consumer Rights Wiki:Wiki policy index|wiki policy]] covers all the guidelines that mature articles need to follow, but reading these guidelines from start to finish may be a daunting task for new contributors. The next section describes the minimum requirements in order to write an article that can be molded into complying with these guidelines in a reasonable amount of time. The last section describes how to edit and create articles.


Don't have a topic to write about? Visit [[Consumer Action Taskforce:How to help|How to help]] to see what the wiki needs!
Don't have a topic to write about? Visit [[Article suggestions]] to see what the wiki needs!
 
==Video guide==
<br />
{{#ev:youtube|KlcXvKTWLY4|720|center|How to create a new article on ConsumerRights.wiki}}


==Minimum requirements==
==Minimum requirements==
Line 12: Line 24:


===Claims must be easily verifiable===
===Claims must be easily verifiable===
 
{{Main|Consumer Rights Wiki:Verifiability}}
A claim is verifiable if:
A claim is verifiable if:
*A verifiable source can easily be found by means of an internet search, or
*A verifiable source can easily be found by means of an internet search, or
*A verifiable source has been referenced using the instructions in [[#Adding references]]
*A verifiable source has been referenced using the instructions in [[Consumer Rights Wiki:Verifiability#How to make an inline citation|adding references]]


Articles should only consist of verifiable claims. Claims that make assumptions or are based on personal experiences or isolated incidents are not valid. For example, "Motorola is pushing updates to their older phones that intentionally slow them down" would only be considered valid if a verifiable source proves it.
Articles should only consist of verifiable claims. Claims that make assumptions or are based on personal experiences or isolated incidents are not valid. For example, "Motorola is pushing updates to their older phones that intentionally slow them down" would only be considered valid if a verifiable source proves it.
Line 23: Line 35:
Every article must include at least one verifiable source. This allows contributors to understand why certain claims were made, as well as to expand on the article using the information provided by the source.
Every article must include at least one verifiable source. This allows contributors to understand why certain claims were made, as well as to expand on the article using the information provided by the source.


For more information about what constitutes a verifiable source, see the [[Consumer_Action_Taskforce:Wiki_content_policies#Verifiability|wiki content policies]].
For more information about what constitutes a verifiable source, see the [[Consumer_Rights_Wiki:Wiki_content_policies#Verifiability|wiki content policies]].


Verifiable sources do not include anecdotal social media posts. For example, the public opinion reflected by the comments under a Reddit post is not a verifiable source.
Verifiable sources do not include anecdotal social media posts. For example, the public opinion reflected by the comments under a Reddit post is not a verifiable source.
Line 31: Line 43:
This wiki is not the place to document isolated incidents, such as a company who unfairly rejected a few warranty claims or a plumbing contractor who charged you more than they should have. The incidents documented in this wiki have affected large amounts of consumers.
This wiki is not the place to document isolated incidents, such as a company who unfairly rejected a few warranty claims or a plumbing contractor who charged you more than they should have. The incidents documented in this wiki have affected large amounts of consumers.


The following examples were summarized from the [[Consumer Action Taskforce:Moderator_guidelines#Example_application_of_rules|moderator guidelines]]:
The following examples were summarized from the [[Consumer Rights Wiki:Moderator_guidelines#Example_application_of_rules|moderator guidelines]]:
;Not systemic
;Not systemic
:*Amazon broke into my garage.
:*Amazon broke into my garage.
Line 40: Line 52:


==Creating an article==
==Creating an article==
Ready to make an new article? Click the [[Consumer_Rights_Wiki:Create_page|Create page]] link on the sidebar. Make sure that the name of the article is singular and in sentence case (only the first word and proper nouns should be capitalized). If you are new around here and not sure how to get started, you can find some tips below.
===Article info form===
Most of the time, upon entering a name for your article, you'll be taken to a form where you can add in some basic info about the subject of your article. Just fill in as much of it as you can, and don't worry about leaving any fields blank, as they can be filled in by yourself or someone else later. The information will be used to auto-populate a table in the article, and provides the wiki with some useful machine-readable data.


To create a new article, click on the [[Consumer_Action_Taskforce:Create_page/many|Create page]] link on the sidebar.
===Basic editing===
*You can make edits using the '''visual editor''' by clicking the "edit" button at the top of an article, or using the '''source editor''' by clicking "edit source" instead.
**The '''visual editor''' is easier to use. It's '''recommended''' to start with this. It's more intuitive in multiple ways, but doesn't allow for complete control like the source editor.
**The '''source editor''' is the advanced editor. Certain things are much easier in it, but it's safe to ignore for your first few edits and check it out when you're comfortable with the visual editor. It allows for direct access to the markup language, and generally has more features and control. One downside is that you have to click '''Preview''' to see how it'll look.
*The wiki uses a markup language called [[mediawikiwiki:Help:Formatting|wikitext]] for formatting. For example, <code><nowiki>'''bold'''</nowiki></code> for '''bold''' text and <code><nowiki>[[link|text to display for the link]]</nowiki></code> for a [[Consumer_Rights_Wiki:Style_guide|link]]. The visual editor can handle most of this.


==Adding references==
:Here are some examples:
:*'''Bold text''': <code><nowiki>'''bold text'''</nowiki></code>
:*''Italic text'': <code><nowiki>''italic text''</nowiki></code>
:*'''''Bold and italic text''''': <code><nowiki>'''''bold and italic'''''</nowiki></code>
:*<s>Strikethrough text</s>: <code><nowiki><s>Strikethrough</s></nowiki></code>
:*Internal link: <code><nowiki>[[Page name]]</nowiki></code>
:*Internal link with custom text: <code><nowiki>[[Page name|custom text]]</nowiki></code>
:*External link: <code><nowiki>[https://example.com Example]</nowiki></code> → [https://example.com Example]
:*Headings: <code><nowiki>== Heading 2 ==</nowiki></code>, <code><nowiki>=== Heading 3 ===</nowiki></code>
:*Lists:
:**Bullet: <code><nowiki>* Item</nowiki></code>
:**Numbered: <code><nowiki># Item</nowiki></code>
:*Sign your comments on talk pages with: <code><nowiki>~~~~</nowiki></code> → automatically adds your name and timestamp. Make sure you always do so when using talk pages.


===New references===
:*You can experiment in the [[Sandbox|sandbox]] if you want to try editing without affecting any real pages.
 
===Adding references===
 
====New references====


To reference a new source:
To reference a new source:
Line 58: Line 93:
     Click on "Insert" → "Citation", or press Ctrl+Shift+K.
     Click on "Insert" → "Citation", or press Ctrl+Shift+K.


    [[File:Screenshot of basic reference button in visual editor.png|196x302px]]
<p>[[File:Screenshot of basic reference button in visual editor.png|196x302px|frameless]]</p>
</li>
</li>
<li>
<li>
     Click the "Manual"  option and choose the type of citation you wish to add.  
     Click the "Manual"  option and choose the type of citation you wish to add.  
[[File:Manual option citations.png|alt=Screenshot of the "Manual" tab when adding citations to a page]]
 
<p>[[File:Manual option citations.png|alt=Screenshot of the "Manual" tab when adding citations to a page|frameless]]</p>
</li>
</li>
<li>
<li>
Line 70: Line 106:
</ol>
</ol>


===Existing references===
====Existing references====


To re-use a source that is referenced elsewhere on the same page:
To re-use a source that is referenced elsewhere on the same page:
Line 83: Line 119:
     Click on "Insert" → "Citation", or press Ctrl+Shift+K.
     Click on "Insert" → "Citation", or press Ctrl+Shift+K.


     [[File:Screenshot of basic reference button in visual editor.png|196x302px]]
     <p>[[File:Screenshot of basic reference button in visual editor.png|196x302px]]</p>
</li>
</li>
<li>Click the "Re-use" option and choose the type of citation you wish to re-use.
<li>Click the "Re-use" option and choose the type of citation you wish to re-use.
[[File:Screenshot_of_re-use_reference_button_in_visual_editor.png|frameless]]<p></p>
<p>[[File:Screenshot_of_re-use_reference_button_in_visual_editor.png|frameless]]</p>
</li>
</li>
</ol>
</ol>