Wikipedia:Wiki Ed/Texas AM/Technical Editing (Spring 2018)

This is an applied course meant to prepare students to function as an editor in technical and professional venues. We will use Wikipedia to specifically target certain less-tangible skills necessary for advanced editing: the ability to join a community of editors that already have standards in place, learn to read and improve writing within those conventions, and learn to facilitate good writing within this existing community. Rather than simply copyediting existing articles, creating new articles, or adding new content to existing articles, the students will focus on finding articles that have a good base of content but which need editorial intervention to help the larger community of potential editors continue to improve the articles. Students will focus primarily on issues of organization, appropriateness, and Wikipedia style, with the aim of significantly improving the existing content of an article. Students will be expected to work within the Wikipedia infrastructure, including engaging with current interested editors and leaving traces of their work to assist with future editing of the articles they worked on.

Week 1
Welcome to your Wikipedia project's course timeline. This page will guide you through the Wikipedia project for your course. We will be using a combination of in class and online instruction as we interface with the Wikipedia community.

Wikipedia offers us the chance to practice editing in an applied context, within an existing culture, and in an online setting. Although anyone can edit Wikipedia, the actual process of becoming a regular contributor requires a little bit of work and, in many ways, mimics the learning curve of editing professionally. Just like any business or organization, Wikipedia editors have developed elaborate protocols for ensuring the quality of edits, standards of articles, and cohesion across entries. Just like any quality online publication, Wikipedia has its own standards for web-publication and even its own markup language, which is a modified version of HTML. Just like any community-based editing, there are sometimes unusual conventions for feedback, cross-checking, and communication as well as an editng culture that reflects the history and ethos of the project. Thus, while anyone can edit, there is still an environment that echoes some essential aspects of editing in workplace settings. We can thus use Wikipedia to perform our own practice of editing in context.

This course has also been assigned a Wikipedia Expert. Check your Talk page for notes from them. You can also reach them through the &quot;Get Help&quot; button on this page.

For this first week, we'll need to get you set up on Wikipedia.


 * Create an account and join this course page, using the enrollment link your instructor sent you. (To avoid hitting Wikipedia's account creation limits, this is best done outside of class. Only 6 new accounts may be created per day from the same IP address.)
 * It's time to dive into Wikipedia. Below, you'll find the first set of online trainings you'll need to take. New modules will appear on this timeline as you get to new milestones. Be sure to check back and complete them! Incomplete trainings will be reflected in your grade.
 * When you finish the trainings, practice by introducing yourself to a classmate on that classmate’s Talk page.

Our task is to think critically about Wikipedia articles so that we can learn to improve the existing content and facilitate future editing. To do so, the first task will be to learn to identify what Wikipedia articles look like and what makes a good one. Then we'll work on finding our own to help improve and make into better ones.

Guidelines and Policies - We want to get a feel for Wikipedia as a living community that nonetheless has developed elaborate rules for itself. These standards are articulated through information pages and supplementary essays as well as brochures produced by the Wikimedia foundation. Below are some useful articles on the basic philosophy and structure of Wikipedia. Using these as a starting point (but following links as needed--you'll quickly see through repetition what Wikipedia editors value and emphasize), spend a few hours getting familiar with the editorial priorities and process used by Wikipedia.


 * Evaluating Wikipedia (brochure)
 * Founding Principles
 * Five Pillars
 * Wikipedia: Plain and simple (pay particular attention to IAR, Be Bold, and Etiquette)
 * Ten Simple Rules for Editing Wikipedia
 * Help: Editing
 * What Wikipedia Is Not
 * Consensus (on what agreement looks like on Wikipedia)

Be prepared to discuss in class.

Everyone has signed up for a Wikipedia account and familiarized themselves with Wikipedia's editing culture.

Week 2
Wikipedia has a nomination and review process to designate &quot;Good articles&quot;. We can use these to get a better feel for what a good article looks like so that we can learn how to recognize an article that needs improvement.


 * Use this link to open 3-4 random Good Articles
 * Looking through these articles consider the following
 * What does a Wikipedia article look like?
 * How are sections used in the articles?
 * How is the article organized?
 * What is the opening portion of an article for?
 * What information is prioritized by the article? What seems to be the appropriate level of detail?
 * Read some sentences closely. What style is appropriate for Wikipedia?
 * How does the article construct an encyclopedic tone and authority? How and where does it use references?
 * Aside from content, what else is present in a good article? (e.g. links, info boxes, images, categories). What functions do these serve?
 * How do conventions and form differ depending on the kind of article?
 * Look at the talk page and editing history. What do these tell you about the editing process that achieved this &quot;good article&quot; status?

Likewise, Wikipedia has a process for nominating articles that need for improvement.


 * Open the list of &quot;Articles for Improvement&quot; here.  (Note: these are only articles that have been nominated for improvement. Many more articles are out there that need improvement so you might not select from this list when you choose you own articles to work on.)
 * Open 3-4 articles from this list and consider the following:
 * Are there any tags indicating what might be the issue with the article?
 * Look at the talk page to see what issues have arisen. (Not all issues will be discussed there).
 * Look at the edit history (of the main page, not the talk page) to see what recent editors have worked on.
 * Scroll through the whole article. How does it look different from the good articles you looked at previously?
 * Consider what might be the problem with
 * Organization of the article
 * Lead description
 * Appropriateness of content
 * Lack of information (needs expansion)
 * Encyclopedic tone
 * Lack of appropriate citations
 * Missing or incomplete tags, categories, links, infoboxes, etc
 * Images and tables
 * Needing copyediting

For two of these articles, write up a bullet-point list summarizing why you think this article was nominated for the &quot;needs improvement&quot; designation.


 * Post these lists on your userpage in a new section (use &quot;=headingtitle=&quot; to start a new section)  along with a link to the article.

As you were looking through the articles that need improvement, you probably found a few small problems that can be easily fixed. To practice editing, go ahead and make at least two changes to these (or any other) articles. A few things to note as you do:


 * Remember, you can use the &quot;edit&quot; tab at the top of the page or the &quot;edit&quot; links at the section headings.
 * We will be using the Wikimarkup language to practice getting familiar with working with mark-up languages. Spend a few minutes looking through the article as it appears in the editing tab so that you can get yourself oriented.
 * Once you make your change, make sure to include a note in the &quot;edit summary.&quot; Keep these as short and descriptive as possible. Look at others in the edit history tab to see what these usually look like.

Use the training module below to get you thinking about how to select an article, but we need to add some more parameters. To accomplish the kind of editing we want for this assignment, we need a particular kind of article.


 * The point of this assignment is NOT to add new content (although you can if it comes up), so only work with articles that have a good base-level of content.
 * Avoid articles that are excessively elaborate, controversial, specialized, or well-trod.  These might be too much to take on for an initial project.
 * Look for articles that clearly don't fit the way a Wikipedia article &quot;looks&quot;. We're aiming particularly for articles that need work on organization, levels of information, tone, style, and appropriateness in addition to copyediting, tagging, and formatting.
 * You might start at the Articles for improvement list we used before or also check out the lists generated from tags that designate need for &quot;style editing&quot; or &quot;copyediting&quot;. However, be selective--while we will copyedit the articles, we also want to be on the look out for the larger, bolder edits needed to take middling articles and push them towards great ones.
 * More articles need this kind of work than you would initially think. So you might be better off going to an article about something that interests you and wiki-surfing from there, looking for articles that need improvement.
 * Before you make your final selections, check the talk page and edit history.  See if there are any recent or significant controversies, edit wars, or recent high traffic on the article. If so, you might want to avoid the article.

With these in mind, pick 3 articles and post them to your user page in the order you would prefer. We'll ultimately work on 2 but we want to have a third on hand in case one of the first two don't work.

Once they are approved, I will assign you the articles in the student tab.

Our goal is to help our articles on their way to &quot;Good article&quot; status. Even if we don't fully accomplish this task, our intervention should lay the groundwork for future editors, especially those knowledgeable about the content, to bring the article to this level. There are a few pages in place to help us see how to do so:


 * The Perfect Article -- a list of what the ideal article should look like
 * Writing Better Articles -- guidelines for what to look for to improve an article
 * Building a better encyclopedia: A systematic approach -- more advice for writing better articles as well as procedures and strategies for handling larger issues that you might run into.
 * Making Technical Articles Understandable -- contains essential advice on Audience and Lead section that applies to more than just traditionally &quot;technical&quot; topics.

Familiarize yourself with the above articles, paying particular attention to the guidelines provides for elements you noticed when we were examining articles earlier this week. At this point you should be getting a much better sense of the task that is ahead of you. Return to these articles as needed throughout the rest of the assignment.

Everyone has been assigned articles

Week 3
Now that you have your articles assigned and a good sense of how to improve them, we now have three related tasks to get us started.

1) Write up the problem


 * You already have some sense of the problems with the articles but now you need to dig in and start looking closely. Reread your articles carefully.
 * Use the pages from &quot;Getting to a better article&quot; to outline what needs to be improved
 * Post this list in your userpage
 * Update it as we proceed and as you find more things to work with.

2) List your tasks


 * Make a bullet-point list of things you need to do.
 * Update this list as you go. Make sure that this is up to date -- I will use it to get a sense of where you are at, what you are working on, and what you have done.
 * When you complete a task, note the date completed.
 * Feel free to use sub-bullets as you find additional sub-tasks to perform.

3) Interface with Wikipedia community. Your article may or may not be currently watched by editors who have worked on it previously. We want to make sure that we engage with the existing community and leave enough space for interaction.

Remember, ''interaction is what makes Wikipedia thrive! '' You do not get to claim the article and cannot put it on hold while you work on it--others  might work on it as well and your edits might even be undone or altered. But there are a few things we can do to let other editors know that you're working on it. Do the following as necessary and fitting for your articles (you decide--gauge what and who is there and don't be afraid to make mistakes!)


 * If you chose an article on the Articles for Improvement list, they ask that you notify that the article has been selected (you can do so through the talk page of the article).
 * Read through the talk page and feel free to contribute your opinion to any controversies that might be lingering.
 * Add a section to the talk page and let the community know that you'll be working on the article for the next few weeks. As concretely and briefly as possible, explain what you plan on doing. Feel free to throw out any questions that you might have. Previous editors who contributed might very well chime in (but they also might not).
 * Consider making your to-do list into a &quot;to-do list&quot; available on the talk page.
 * Look through the history of the main page and note the major editors involved. These are likely the editors who will come back to look at how the page is evolving.
 * How is the article rated? Is it a part of any WikiProjects?
 * Click the star next to &quot;view history&quot; on your articles and their talk pages to add them to your watch list. When edits are made it will show up in your watchlist.

As you work, feel free to post edits as you go or to work on sections in your sandbox. Wikipedia records all edits so I'll be able to trace your progress as you go and see how much and what you changed. Remember, we're aiming for significant improvement but this won't happen all at once. In fact, to ensure proper integration into the Wikipedia community, you shouldn't post all changes at once but post as you go.

While many articles are initially put together by a single author, many are patched together often over years of edits by many different writers. Often, structural decisions made years ago will be left in place and thereby frame future edits. Meanwhile, content may be added into random places or just tacked on the end. Thus, the first place to start with any article is thinking about organization.

Guideline pages to consult:


 * Layout
 * Lead Section

Assess your articles


 * Does your article follow the basic layout structure of a Wikipedia article? Compare your article with other articles of its type or category in order to identify additional conventions related to this particular article.
 * What is the organizational flow of the article? Does it need a major restructuring?
 * Is there information out of place? Is everything in a sensible order? Is everything given proper emphasis?
 * Are there any sections that are too long or too short? Is there a way to rework it to avoid this? (Keep in mind that you might want to keep a short section if the division is appropriate but the content has not yet been provided).
 * Does the lead section provide the appropriate level of information? Should some information be moved down or brought up from the main content?
 * Examine the internal structure of each section. Is the information in the most logical order? Do likewise with each paragraph.

Add anything new that you find to your list of problems and tasks and begin making edits as needed.

''Note that if you are making major changes to the organization, you might want to let the Wikipedia community know first and give a clear rationale for it in the talk page. These are often the most bold edits since they can rearrange a whole article. Don't be afraid to do it but make sure that you're clear about why and be open to push-back. ''

Many problems that arise in Wikipedia come from how the article is focused--what information is focused on and how might it be skewed towards one perspective? Because those who are invested in a topic are likely to be the ones who contribute significant content, some work usually has to be done to adjust the article to ensure that it is balanced and focused properly.

Here are the three primary guidelines about content:


 * Neutral Point of View
 * No Original research
 * Verifiability

Assess your articles:


 * Is everything in the article relevant to the article topic? Is there anything that distracted you?
 * Is the article neutral? Are there any claims, or frames, that appear heavily biased toward a particular position?
 * Are there viewpoints that are overrepresented, or underrepresented?
 * Does any of the information read as original research?
 * Think about the citations. Do the sources support the claims in the article? Are there places where more sources are needed?
 * Is each fact referenced with an appropriate, reliable reference? Where does the information come from? Are these neutral sources? If biased, is that bias noted?
 * Is any information out of date? Is anything missing that could be added?

Add anything new that you find to your list of problems and tasks and begin making edits as needed.

Every student has listed their tasks to be completed and begun work on organization and content-focus problems.

Week 4
Wikipedia is supposed to sound like an encyclopedia. This ideal of a clear, informative, and neutral tone can be hard to achieve, but a good editor can usually spot when the style is NOT these things. Now that you have examined the content and organization closely, it is time to look carefully at the sentences and make improvements.

A warning: one can endlessly re-craft sentences and so Wikipedia editors tend to discourage excessive or minor fiddling with sentences. Focus primarily on substantial and needed improvements. When you make a change, try to indicate why the edit was needed citing the relevant policy page if possible (e.g. &quot;Rephrase to conform to WP:NPOV&quot;)

Guidelines for tone and clarity


 * Encyclopedic tone
 * What Wikipedia is Not (often referred to as WP:NOT) -- sections of this deal specifically with tone problems.
 * Words to Watch -- these are not so much problem words as red flags that signal a deviation from encyclopedic tone.
 * Making Technical Articles Understandable (review this article for advice for when your article might become stylistically dense)

Read carefully through your article, keeping a close eye out for:


 * Any lingering NPOV issues that might exist on the sentence-level.
 * Over editorializing or other problems with conciseness
 * Unnecessarily complex or convoluted sentences
 * Ambiguous sentences
 * Order of information within a sentence, particularly in relation to citation.

Make changes as you find them. On your list of tasks and problems, you can just summarize what you found and did--there is no need to add every change to your list of tasks.

Before we finish, three final steps are necessary to ensure that your article is in good shape both now and for future editing. Remember, the goal here is not necessarily a polished and finished article--although if you end up with one, great! Rather there are things we can do even with an article that still needs work to help future editors get the article there.

1) Copyedit - Take one final pass through the article looking carefully for grammar, usage, and formatting issues. Where necessary consult the Wikipedia Manual of Style.  (Please note that when two uses are equally acceptable, you don't change it. For example, if there is a British spelling don't change it to the American spelling. A more complete list of such problems can be found here.)

2) Polishing and formatting infoboxes, links, categories, references, and images - Review the standards provided at the following locations:


 * Guidelines on links
 * Infoboxes
 * Categorization
 * Citations
 * For images see the training below

3) Template messages and community notification: for various reasons, you might not be able to fix everything. Perhaps the article needs more content, perhaps it needs better sources, perhaps the article might need a more significant change such as merging, splitting, significant rewriting that is beyond your current capacity, or even deleting. In any of these cases, this is not a problem. Instead, you can do the following to engage current a future editors in the continuing process of developing the article.


 * Update or add to the talk page indicating the current status of the article and any open questions or major issues still in play
 * Update, remove, or add improvement template messages. Be sure to follow the guidelines at this link before placing or removing templates. Remember, these can be placed on the whole article or within individual sections.
 * Add or update reference requests as needed.
 * If further arbitration is needed, you can work with our Wikipedia editors and possibly submit the more significant changes through the necessary venues.

Read Editing Wikipedia page 15 to review a final check-list before completing your assignment.

Significant improvements have been made to the articles.

Week 5
To assist with evaluation, please send me an email (this email will also signal to me that you are finished and your edits ready to be examined) containing a written summary of your time working with Wikipedia as well as a reflection on the process. Please include information about:


 * Critiquing articles: What did you learn about Wikipedia during the article evaluation? How did you approach critiquing the article you selected for this assignment? How did you decide what to add to your chosen article?
 * Summarizing your contributions: include a summary of your edits and why you felt they were a valuable addition to the article. How does your article compare to earlier versions?
 * Peer Review:  What did you contribute in your review of your peers article? What did your peers recommend you change on your article?
 * Feedback: Did you receive feedback from other Wikipedia editors, and if so, how did you respond to and handle that feedback?
 * Working with Wikipedia: What did you find challenging about working with Wikipedia? What did you learn about the editorial process?
 * Thoughts on the Assignment: What did you like most about the assignment. Is there anything you would recommend to be changed for next time?

Everyone should have finished all of the work they'll do on Wikipedia, and be ready for grading.