Debatepedia User Guide
|Revision as of 01:59, 14 June 2008 (edit)
Brooks Lindsay (Talk | contribs)
← Previous diff
|Revision as of 02:03, 14 June 2008 (edit)
Brooks Lindsay (Talk | contribs)
(→The Goal: An encyclopedia of pros and cons and supporting quotations)
Next diff →
|Line 6:||Line 6:|
|Click on the "log in / create account" button in the upper-right of your screen and enter your basic information. We encourage you to use your real name as your "user name". You will be able to use your [[Debatepedia:User pages| user page]] as a profile and bio page, so it may be worthwhile for you to provide a real name and build your actual profile.||Click on the "log in / create account" button in the upper-right of your screen and enter your basic information. We encourage you to use your real name as your "user name". You will be able to use your [[Debatepedia:User pages| user page]] as a profile and bio page, so it may be worthwhile for you to provide a real name and build your actual profile.|
|-||== The Goal: An encyclopedia of pros and cons and supporting quotations ==||+||== The mission: Creating an encyclopedia of pros and cons and supporting quotations ==|
|Debatepedia's mission is to act as an encyclopedia of pro and con arguments and quotations in all major public debates around the world. This mean, in any given article, that the objective is to document every single pro and con argument and all supporting quotations from the key leaders and players in the debate and from the primary pro and con articles and essays. This is what you and other editors are striving to achieve in articles that you edit.||Debatepedia's mission is to act as an encyclopedia of pro and con arguments and quotations in all major public debates around the world. This mean, in any given article, that the objective is to document every single pro and con argument and all supporting quotations from the key leaders and players in the debate and from the primary pro and con articles and essays. This is what you and other editors are striving to achieve in articles that you edit.|
Revision as of 02:03, 14 June 2008
This page is a tutorial on all of the basic, need-to-know things on Debatepedia. It will jump-start your ability to browse, edit, and engage with the Debatepedia community.
Registering and logging in
Click on the "log in / create account" button in the upper-right of your screen and enter your basic information. We encourage you to use your real name as your "user name". You will be able to use your user page as a profile and bio page, so it may be worthwhile for you to provide a real name and build your actual profile.
The mission: Creating an encyclopedia of pros and cons and supporting quotations
Debatepedia's mission is to act as an encyclopedia of pro and con arguments and quotations in all major public debates around the world. This mean, in any given article, that the objective is to document every single pro and con argument and all supporting quotations from the key leaders and players in the debate and from the primary pro and con articles and essays. This is what you and other editors are striving to achieve in articles that you edit.
The below articles are some models of these standards (although they are still not perfect). You should aim to emulate these articles in creating your Feature Debate Articles each week. In general, the best way to learn how to do something editorially is to find where it is done right on a model debate, click "edit", observe the wiki code used to produce what you want to produce, and emulate what you see.
Writing model arguments
Arguments are the basic units of a debate. You must know how to write good arguments and in Debatepedia's simple format. Here is what a good argument looks like on Debatepedia:
- Offering drivers licenses to illegal immigrants will make roads safer in the US With millions of illegal immigrants lacking drivers licenses, there are millions of drivers on the road who have not taken a driver's license test and who probably do not know the traffic safety laws. Issuing driver's licenses to illegal aliens and requiring that they take a driving test would help resolve this safety hazard.
Or, you could use a supporting quotation to summarize the argument, making it look like this:
- Offering drivers licenses to illegal immigrants will make roads safer in the US Sam Gomez. "Should illegal immigrants be granted Driver Licenses in New York State?" Clarkson Integrator. December 12, 2007 - "The last real benefit of the policy change is the most obvious; safer streets. We all remember taking driver ed, the signs, parallel parking, three point turns, the works. Obviously, people who do not have to pass that rigorous rite of passage known as 'the driving test' aren't going to be well equipped to handle driving on congested roads. Not knowing the rules of the road aside, the AAA Foundation for Traffic Safety found that unlicensed drivers are five times more likely to be involved in a fatal accident than validly licensed drivers. Clearly, safer roads would also be good for everybody."
Some of the key features of this model argument include:
- A bullet point should start arguments for visual reasons.
- The "claim" is essentially a one sentence summary of the argument's conclusion. It is basically a header for an argument. It should be as concise and to-the-core-point-of-the-argument as is possible. The rule of thumb is that it take up no more than a single line the pro or con side of a debate, which requires that it be very concise. Part of the reason for this is that "claims" are what are made into the titles of argument pages (below).
- Argument summaries come after the "claim". This is where a more detailed, generally three to five sentence, description of the argument is presented.
- Or, a summarizing quotation after the claim. It is good to have a balance of argument summaries and summarizing quotations on a debate article.
- Link to argument page/evidence: The above arguments have a link to their own argument pages. Argument pages are whole pages dedicated to a single argument, with the "claim" being the title of the argument page (click on the above argument). On these pages, supporting evidence (quotes, studies, facts) can be presented in mass in support of an argument. The example provided above demonstrates that the "claim" is made into the title of the argument page. The next section shows you how to create these pages.
Creating argument pages
You can create these pages very easily, simply by putting "[[ ]]" around the claim. But, we like to preface the claim on these pages with "Argument". So, click "edit" here and view what this looks like in the wiki code with the above argument. As you can see, "Argument:" does not appear in the rendering (when you press save). This is because the code is written like this: '''[[Argument: Offering drivers licenses to illegal immigrants will make roads safer in the US| Offering drivers licenses to illegal immigrants will make roads safer in the US]]'''
See main article on this: Debatepedia:Argument pages
Taking a debate from start to finish
- Step 1: Compile a pro/con resources section Because the objective in each article is to document public debates and all the primary pro and con arguments and quotations in them, the first place to start in a debate article is in creating the "the pro/con resources" section. This section is split-screen section that should appear at the bottom of the pro/con section of a debate article. In this section, you will document the primary pro and con articles, essays, and cases in the public debate. These will be the resources that you will draw from and quote from in compiling pro/con arguments in your debates. You should search for these cases through Google, Google Scholar, Ask.com, Lexus Nexus (if you have access), and other search engines. Key word selection is fairly important. Some recommended search key words include:
- The topic: "Capital Punishment", "The Death Penalty", and iterations of the topic name.
- "The case for/against..."
- "Arguments for/against..."
- "Pro/cons of..."
- "Why ban assault weapons"
- Once you've found an article, use MLA referencing style to compile the list of pro and cons resources.
- Step 2: Draw arguments and quotations from articles you've compiled. Search for and isolate specific arguments made in these cases. Let's say you find an argument along the lines that US roads would be made safer by offering driver's licenses to illegal immigrants. The first thing you'll want to do is isolate and widdle down this "claim". So, "Offering drivers licenses to illegal immigrants will make roads safer in the US". Then, you would want to create a basic argument summary: "With millions of illegal immigrants lacking drivers licenses, there are millions of drivers on the road who have not taken a driver's license test and who probably do not know the traffic safety laws. Issuing driver's licenses to illegal aliens and requiring that they take a driving test would help resolve this safety hazard." Now, imagining that you want to quote a specific argument made in the article you're reading as "a supporting quotation" on Debatepedia, you will have to create an argument page (see section below). Once you've done this, you should create a "supporting evidence" section by writing "==Supporting Evidence==" into the editing window of your new argument page. Now, you can cut-and-paste a quote from one of your sources under this "supporting evidence" section. Next, you will have to make an external link to the resource that you are quoting.
- [http://blog.wired.com/cars/2007/10/illegal-immigra.html "Illegal Immigrants, Driver's License Crash Into American Consensus". Wired Magazine. October 04, 2007] - "New York Gov. Eliot Spitzer loves a fight. But his policy to allow illegal immigrants to obtain driver's licenses, announced just weeks ago, has even his closest loyalists in a sweat. His reasoning is that denying immigrants the legal right to drive hasn't stopped them from driving. After all, they're already breaking the law just by being here. By driving illegally, they don't have insurance, which has contributed to more hit-and-run accidents as well as higher insurance premiums for everyone else." Read through all the articles you've compiled and draw from them in documenting arguments and quoting and gathering supporting evidence.
- Step 3: Keep referring back to high-level feature debates and emulate them.
Creating debate pages
- Create new debate, argument, and other pages. You can create both debate and argument pages on Debatepedia. There are different processes for doing both of these things (see the link), but you should keep in mind that you are free and encouraged to create new pages. If there is a notable public debate in the world that doesn't already exist on Debatepedia, you should create it. The same applies to argument pages.
See also Help:Editing
You must abide by Debatepedia's editing policies. If your edits break these policies, other users have the right to delete or change what you have done into compliance with these policies. These policies include:
- Debatepedia is an encyclopedia of debates, arguments, and debate-related materials. Debatepedia is an encyclopedia for the documentation of existing, notable public debates and the primary pro/con arguments and evidence within them. Debatepedia does allow arguments to be presented in an assertive, biased form so that they read as if the author is making them. But, this is mainly for posterity, so that arguments are read in their more "natural" form (how you might hear them or make them).
- Sober language. While assertive language can be used, passionate language is not allowed.
- Fair and balanced articles. As an encyclopedia, the ultimate goal is to achieve a fair and balanced presentation of a debate, its arguments, and the supporting evidence (quotes, articles, links) within.
- Arguments must be based on and cited to reliable published sources: Arguments on Debatepedia must be backed-up by supporting evidence that is derived from and cited to reliable published sources.
- Arguments must be logically consistent. Arguments must follow basic laws of logical consistency and validity, avoiding tangents, and staying focus on justifying the claim or conclusion that is being asserted (the "claim" should be a very short bolded sentence at the beginning of an argument that explains the jist of the argument).
- Debate questions and subquestions must be neutral in orientation. Loaded questions and subquestions are not allowed on Debatepedia. A debate's main question should frame a public debate in a fair and balanced weigh. Subquestions should simply act as a way to break-down a debate into its more chewable subdebates (economic, social, legal pros and cons...).
See also Debatepedia:Editing policies
Editing debate pages
Debate pages on Debatepedia are based on a unique pro/con "logic tree" structure. Debates start with a main "yes"/"no" question. The pro/"yes" and con/"no" arguments are then divided into a split screen with pros on the left and cons on the right. Subquestions help organize the pros and cons of often large debates into more chewable parts (economic, social, legal...). Subquestions are simply there for the purpose of organizing pros/cons within the larger debate or "yes"/"no" question; they are not there for opening tangential debates to the main debate/question.
Manipulating the Debatepedia "logic tree" structure and software: In coordination with IDEA, Debatemedia Inc. developed with a great Indian software firm called QuadOne special software so that you can effectively manipulate Debatepedia's unique "logic tree" architecture on debate pages. With this software, editors can:
- Shift up or down subquestion sections and their contents (arrow icons): This is important for structuring: moving around the subquestion, sub-debate sections so that the "logical" flow of a debate is maintained. Typically, the most important sub-debates within a larger debate should appear at the top.
- Insert new subquestion sections (box icon): Because there are varying numbers of sub-debates within a debate, users must be able to add new subquestions sections. The box icon allows for this.
- Delete old or unneeded subquestions (red icon): Users must also be able to delete old subquestion section shells that are no longer needed.
WARNING: Debate pages have table code that creates the pro/con structure of these pages. Do not delete or alter this code. Furthermore, if you click on the editing pencil for the "yes" box, for example, you will see the table code for the "no" box on that page. Make sure to write add content for the "yes" box above this table code. If you write content below this code, the content will actually appear in the "no" box.
Editing argument pages
On debate pages, arguments are presented that often have a vast array of supporting evidence in the form of quotes, links to articles making an argument, studies, or simply facts that can be reasonably brought together to support an argument. For this reason, we allow for argument pages to be created and linked-to from debate pages. Doing this is fairly simple. On debate pages, arguments are presented first by their "claim", which is a brief one sentence summary of an argument's main point. For example, "capital punishment deters crime" is a "claim", and this would be presented on a debate page at the beginning of a larger summary of that argument. This "claim" can be made into the title of its own argument page. Doing this is very simple. Once you have the "claim" on the debate page, all you have to do is click edit, place two brackets on both sides (two, not one on each side) of the argument "claim". Press save and click on the new red argument, whereupon you will be taken to the new argument page where you can document supporting evidence for the argument.
Creating new debate pages and regular pages (argument pages, organization pages...)
You can create new pages whenever you want on Debatepedia. Debate pages are pages with the pro/con "logic tree" structure. These pages also have the special QuadOne software that enables you to manipulate the Debatepedia structure effectively. Regular pages are ordinary blank pages. These are used for argument pages, administrative pages (like this one), regular encyclopedic articles (ones about a certain notable individual in the history of public debate and deliberation), and for a variety of other purposes.
Key editing tools and functionalities
- The toolbar at the top of an editing window. When you're in an editing window, put your cursor over the toolbar that appears just at the top of the window. These tools are very useful, and include bolding, italics, internal linking, external linking, and many other functionalities.
- Create internal links between pages on Debatepedia by placing "[[Title]]" around the title of a page you are trying to link to.
- Make an internal link, but with hyper-link in blue as different wording (maybe shorter or without caps) than the title you're linking to [[Title| desired wording]]
- Create external links by writing: "[url Wikipedia article on capital punishment]" (by creating a space between the end of the url and "Wikipedia article...", you will hyperlink "Wikipedia article..."). You'll often be hyperlinking an author, title of an article,... as an introduction to a quote.
- Making a bullet point. A bullet point can be used to start-off a unique argument. Use an asterix in an editing window to do this.
Communicating with other members of the community
Debatepedia is a community of editors like you, and we encourage you to communicate with the rest of this community by going to the Main Page discussion page, the talk pages of articles, or to the user pages of other members of this community (user pages are best accessed by going to the "history" tab at the top of the screen and seeing who has contributed what to an article of interest to you). You are welcome to write almost anything on these pages (questions, comments, suggestions), as long as it's appropriate and relevant to the other user and the Debatepedia project.
We also encourage you to communicate directly with Brooks Lindsay the founder and chief editor of Debatepedia. You can also contact us by email or phone with any of your questions. We're here to answer your questions and help integrate you into the Debatepedia community, so really feel free to send us a message, email, or give us a phone call.
Almost everything on Debatepedia can be accessed through the "navigation" and "interactions" boxes in the upper left part of the screen as well as the toolbar on the upper right part of the screen.
- The contents page is your access portal to all categories, portal, articles, and other areas on the site.
- If you are looking for ways to contribute, go to the community portal, where tasks that need doing are listed.
The case for editing on Debatepedia
The first reason to join Debatepedia and begin editing is self-interested. Debatepedia is the ideal way to deliberate on the tough questions that surround us in society, so that we can take firm positions as citizens and vote effectively. This is not only in reading existing Debatepedia articles, but in using Debatepedia to frame the arguments and evidence we come across in newspapers, journals, books, and other places so that we can better deliberate, draw conclusions, assert personal positions effectively within our communities, and vote with confidence.
The second reason for joining Debatepedia as an editor is social. Just as you can benefit from reading pro/con articles and rataionlizing your own position, others benefit from this too. When you write pro/con articles and help break-down and frame a debate on Debatepedia, you are making it easier for other people to think-through that debate, draw conclusions, and act effectively as a citizen.
- See also the mission and vision of Debatepedia for a greater understanding of what we are after.
What are Debatepedia's standards
You and other editors are tasked with moving the articles that you engage on to feature article status. These are exemplary articles on Debatepedia, that abide by Debatepedia's editing policies, and uphold a variety of Debatepedia's highest quality standards. For debates, it's where all the core arguments are clearly and fairly presented, and the core supporting evidence, quotes, studies, and articles are presented as well on argument pages linked out from Debate pages. Feature articles should also have the positions of the all the key, relevant politicians, organizations and activist groups, country governments, and other stakeholders.
Editors that create feature articles are rewarded with awards on their users pages and possible being given administrator editorial privileges as well as having their article "featured" on the main page of Debatepedia and in the hall of feature articles. See Debatepedia Steward
- See Help:Editing, which acts as a full guide to editing on Debatepedia.
- Also see Wikipedia's tutorial on editing, which will help you learn the very basic and most important MediWiki (the software Wikipedia and Debatepedia uses) editing techniques and tools.