Difference between revisions of "Help:Editing a page"

From Ballotpedia
Jump to: navigation, search
(updated category)
(updated and expanded page)
Line 1: Line 1:
 
{{help}}{{tnr}}
 
{{help}}{{tnr}}
  
'''Editing pages on Ballotpedia''' is simple. If you haven't already, take a minute to walk through the '''[[Ballotpedia:A Quick Overview|Ballotpedia Tutorial]]'''. For specific quick tips on creating links and formatting text, see the '''[[Help:Quick guide to editing|Quick guide to editing]]'''.
+
'''Editing pages''' on Ballotpedia in its most basic form is similar to writing an e-mail. This article describes the basics every editor needs to understand to edit a page, and directs you to the resources that will assist you in learning wiki code.
  
{{Important new user}}
+
==Editing a page==
 +
There are just a few steps you need to follow in order to make and save an edit on Ballotpedia:
  
==Correcting text==
+
#Click the <code>"Edit"</code> menu tab that appears in the horizontal menu bar at the top of the article.
Fixing errors is how many people make the jump from <i>reading</i> a wiki to <i>editing</i> one. You want to fix that typo, don't you? To do so, click the '''edit''' tab at the top of the page, find the error, fix it, and press the "show preview" button to check your work, and then the "save page" button on the bottom of the page. Easy!
+
##Once in the edit window, you will either see a space that is blank (if you are just [[Help:Starting a page|starting an article]]) or full of type from the existing article. You can change the existing type or create any type you would like in this box.
 +
#Make your edit. Edits can be large (a whole new page or section) or small (a tiny adjustment in wording or the addition of a picture).
 +
# Preview your edit. You can preview your edit by clicking the <code>"Show preview"</code> button at the bottom of the page. This button appears between the <code>"Save page"</code> button and the <code>"Show changes"</code> button.
 +
# Verify your desired changed by reviewing the page preview.
 +
# Fill in the summary bar directly following the edit window. Your summary does not have to be long, or in sentence format, but should quickly spell out for other readers the work you did on the page (for example, ''fixed grammatical error''). Your summaries will be catalogued on the <code>"View history"</code> tab of the page.
 +
# Save your edit by clicking the <code>"Save page"</code> button that appears on the bottom left of every <code>"Edit"</code> page.
  
==Adding content==
+
You have now published an edit on Ballotpedia.
Say you're reading an article and you think the author left something out. Decide where your addition makes the most sense in the article, click '''Contribute''', and add your text.  
+
  
Some editors prefer to write their additions in their computer's text editor and then copy it into the wiki. Also, it's good manners to fill in the "summary" bar at the bottom of the page before saving your edits, so future editors will know ''what'' you changed and ''why'' you changed it.
+
Beyond those basic steps of adding content, editing a page may require you to use wiki code, also known as wiki markup, to affect the visual appearance of the page. Much of wiki code is very simple, and can be easily learned. For basic elements that will be very helpful to you, see the [[Help:Cheatsheet]].
  
Sometimes you'll disagree about what should be included in an article. That's natural, so discussion about resolving disagreements should occur in the '"Discussion"' tab at the top of the page, rather than by taking turns deleting someone else's contributions or having them delete your own.
+
Though you can always choose to code the appearance of a page yourself, you can also always copy the code from an existing page that you want to emulate the appearance of and modify it to fit your needs, reducing the time needed to learn wiki markup and code your edit.
  
==Creating new content==
+
==Correcting text==
Once you're comfortable editing pages and changing other people's content, why not add some of your own? There are two ways to about create new pages and they both involve using [[red links]]. A <span style="color:red">red link</span> is a link that doesn't exist... yet. It's a piece of text placed in the double brackets <tt><nowiki>[[ ]]</nowiki></tt> which make it an internal link. These links encourage (or remind) the community to follow up on that subject. To use them:
+
Fixing errors is how many people make the jump from reading a wiki to editing one. When you come across an error, follow the steps above to open the edit window, correct the error and save your changes.
  
* Follow a <span style="color:red">red link</span> on a topic that interests you
+
==Adding content==
** '''Example:''' You see on the [[List of ballot measures by topic]] that a topic is a red link. You happen to know about the topic, so you decide to start the page by clicking on that link.
+
If you are reading an article, and you think the author left out an important fact, click the <code>"Edit"</code> menu tab and plug your addition in following the steps in the [[#Editing a page|Editing a page]] section above.
  
* Find a page that would lead naturally to the topic you want to post about, and edit it to create a red link
+
From time to time there will be disagreement on what ought to be included in an article. Editorial discussion is normal and encouraged, but should not take place on the content page. If you have a question about content that has or has not been included in a page, visit the [[Help:Talk page|Talk page]] of the article and leave a question or comment.
** '''Example:''' On the [[Illinois]] page you notice that a new ballot drive has nothing written about it. So you edit the [[Illinois]] page to make a link leading to the ballot drive you know about, then you use the link you just created to write a new page.
+
  
 
==See also==
 
==See also==
* [[Ballotpedia:Ways you can help|Ways you can help]]
+
* [[Help:Cheatsheet]]
* [[Ballotpedia:How to contribute to Ballotpedia|How to contribute to Ballotpedia]]
+
* [[Help:Talk page]]
 +
* [[Help:Quick guide to editing]]
 +
* [[:Category:Intro editing help]]
 +
* [[:Category:Advanced editing help]]
 +
* [[Ballotpedia:Ways you can help]]
 +
* [[Ballotpedia:How to contribute to Ballotpedia]]
  
 
[[Category:Intro editing help]]
 
[[Category:Intro editing help]]
[[Category:Writing guidelines]]
 

Revision as of 15:16, 3 January 2014

Editing Help
1328101905 Help.png
Index
Editing guide
Cheatsheet
Policies
Copyright
Textual standards
Visual standards
Glossary of terms
Edit review process

Editing pages on Ballotpedia in its most basic form is similar to writing an e-mail. This article describes the basics every editor needs to understand to edit a page, and directs you to the resources that will assist you in learning wiki code.

Editing a page

There are just a few steps you need to follow in order to make and save an edit on Ballotpedia:

  1. Click the "Edit" menu tab that appears in the horizontal menu bar at the top of the article.
    1. Once in the edit window, you will either see a space that is blank (if you are just starting an article) or full of type from the existing article. You can change the existing type or create any type you would like in this box.
  2. Make your edit. Edits can be large (a whole new page or section) or small (a tiny adjustment in wording or the addition of a picture).
  3. Preview your edit. You can preview your edit by clicking the "Show preview" button at the bottom of the page. This button appears between the "Save page" button and the "Show changes" button.
  4. Verify your desired changed by reviewing the page preview.
  5. Fill in the summary bar directly following the edit window. Your summary does not have to be long, or in sentence format, but should quickly spell out for other readers the work you did on the page (for example, fixed grammatical error). Your summaries will be catalogued on the "View history" tab of the page.
  6. Save your edit by clicking the "Save page" button that appears on the bottom left of every "Edit" page.

You have now published an edit on Ballotpedia.

Beyond those basic steps of adding content, editing a page may require you to use wiki code, also known as wiki markup, to affect the visual appearance of the page. Much of wiki code is very simple, and can be easily learned. For basic elements that will be very helpful to you, see the Help:Cheatsheet.

Though you can always choose to code the appearance of a page yourself, you can also always copy the code from an existing page that you want to emulate the appearance of and modify it to fit your needs, reducing the time needed to learn wiki markup and code your edit.

Correcting text

Fixing errors is how many people make the jump from reading a wiki to editing one. When you come across an error, follow the steps above to open the edit window, correct the error and save your changes.

Adding content

If you are reading an article, and you think the author left out an important fact, click the "Edit" menu tab and plug your addition in following the steps in the Editing a page section above.

From time to time there will be disagreement on what ought to be included in an article. Editorial discussion is normal and encouraged, but should not take place on the content page. If you have a question about content that has or has not been included in a page, visit the Talk page of the article and leave a question or comment.

See also