Difference between revisions of "Help:Editing a page"

From Ballotpedia
Jump to: navigation, search
(updated category)
m (Reverted edits by Maryjanesanchezfulton (talk) to last revision by BaileyL)
 
(7 intermediate revisions by 5 users not shown)
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:
 +
 
 +
#Click the <code>"Edit"</code> menu tab that appears in the horizontal menu bar at the top of the article.
 +
##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.
 +
 
 +
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==
 
==Correcting text==
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!
+
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==
 
==Adding content==
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.  
+
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.
  
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.
+
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.
  
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.
+
==Checking your edit==
 +
It is vitally important to check your work before saving an edit. You will be working with wiki-code while editing, which can make it quite easy to make a mistake, especially if you are new to coding. Follow the steps below to check an edit before saving, ensuring that you leave an error free page for subsequent visitors.
  
==Creating new content==
+
===Steps to follow===
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:
+
Follow these steps to check your work before you save:
  
* Follow a <span style="color:red">red link</span> on a topic that interests you
+
* Read through the edit box and scan for errors in formatting, code, spelling and grammar. Many browsers have spell checking features embedded within them, and there are many browser extensions you can find that will assist you in spell checking and grammar checking your edit.
** '''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.
+
* Once you have done an inspection of the code, click the box at the bottom of the edit page that says "show preview."  When clicked, this function will load a published preview of your edit. A notice will appear at the top of the page, which states, "<span style="color:#FF3300;">'''Remember that this is only a preview.''' Your changes have not yet been saved!</span>" Below that notice, your edit will be displayed, followed by the edit window at the bottom of the page.
 +
* In the preview, click through any [[Help:Links#External links|external links]] you have added to make sure they go where you intend them to. It is also a good idea to check existing external links, as they may be out of date or broken. If any links you check are non-functioning, go to the edit window and correct them.
 +
* After you have checked and made any necessary corrections to your work, save your edit by clicking the "Save page" button at the bottom of the page.
 +
** If the edit you have made is small, such as a slight rearrangement of text or the correction of a misspelling, be sure to click the "This is a minor edit" check box after your edit summary. For more information on minor edits, see the [[Ballotpedia:How to contribute to Ballotpedia#Minor edits|Minor edits section]] of the [[Ballotpedia:How to contribute to Ballotpedia|How to contribute to Ballotpedia]] page.
  
* Find a page that would lead naturally to the topic you want to post about, and edit it to create a red link
+
Please note that you can use the "show preview" button as many times as you like to make sure the results are what you expect, just don't forget to click "save" once you are done with your edit.
** '''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]]
 

Latest revision as of 07:54, 30 June 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.

Checking your edit

It is vitally important to check your work before saving an edit. You will be working with wiki-code while editing, which can make it quite easy to make a mistake, especially if you are new to coding. Follow the steps below to check an edit before saving, ensuring that you leave an error free page for subsequent visitors.

Steps to follow

Follow these steps to check your work before you save:

  • Read through the edit box and scan for errors in formatting, code, spelling and grammar. Many browsers have spell checking features embedded within them, and there are many browser extensions you can find that will assist you in spell checking and grammar checking your edit.
  • Once you have done an inspection of the code, click the box at the bottom of the edit page that says "show preview." When clicked, this function will load a published preview of your edit. A notice will appear at the top of the page, which states, "Remember that this is only a preview. Your changes have not yet been saved!" Below that notice, your edit will be displayed, followed by the edit window at the bottom of the page.
  • In the preview, click through any external links you have added to make sure they go where you intend them to. It is also a good idea to check existing external links, as they may be out of date or broken. If any links you check are non-functioning, go to the edit window and correct them.
  • After you have checked and made any necessary corrections to your work, save your edit by clicking the "Save page" button at the bottom of the page.
    • If the edit you have made is small, such as a slight rearrangement of text or the correction of a misspelling, be sure to click the "This is a minor edit" check box after your edit summary. For more information on minor edits, see the Minor edits section of the How to contribute to Ballotpedia page.

Please note that you can use the "show preview" button as many times as you like to make sure the results are what you expect, just don't forget to click "save" once you are done with your edit.

See also