Extension:PeerEvaluation/How to use Peer Evaluation

Overview
This is a quick start guide that lets one enable peer evaluation for an activity based on submissions as a blog post/wiki page.

For more details on peer evaluation, please view the following pages:
 * Peer evaluation OERu project page
 * The wikieducator peer evaluation extension page

To use Peer evaluation you need to do the following tasks:
 * Create an activity submissions page - this is the place where the submissions will be stored.
 * Place the submit activity tag - this will enable you to accept submissions for an activity.
 * Create a rubric as per the prescribed format and put it on a wiki page.
 * Place the evaluations tag - this lets a learner view the submissions that are available for evaluation so that he can go on to evaluate them.
 * Place the view evaluations tag - this lets anyone view the evaluations submitted for the activity.

The details of the above steps are described below.

Creation of an activity submissions page
Create a page somewhere in the wiki, where you would want the submissions to be stored, with the following text. Make sure that this page is not deleted or modified manually after creating it for the first time. Also, it should be a new page with only the text as described below.

This page is created and updated automatically. Do not manually edit it.
Let the URL of the page created with the above content, relative to the home page be urlofActivities. We will require this URL in the later steps to accept submissions and also to view submissions available for evaluation.

Examples :
 * If you created the page http://wikieducator.org/User:Akashagarwal/sample-activitytable, urlofActivities = User:Akashagarwal/sample-activitytable
 * Similarly, For http://wikieducator.org/ActivitySubmissions, urlofActivities = ActivitySubmissions

User experience
Although as this is a wiki page and is hence publicly available, you may decide whether to share the link with your learners or not. You may want the learners to be able to look at all submitted activities. In this case you can include this page as a part of the flow of your course. But, do let them know, not to manually edit this page.

Creation of a rubric
Now, create a wiki page which contains rubrics on which you would like to Peer Evaluate. Reference for the Rubric Format

We assume the URL of this page is urlofRubric just like that of an Activity submissions page.

User experience
You do not need to share this page with the learners as the rubrics will be visible to them as a form when they submit a evaluation using the corresponding tag. You can edit this page if you decide to change the rubrics at some point of time. To incorporate the change in the page where you display the submissions available for evaluation, you may need to refresh it with appending "?action=purge" at the end of the URL.

Tag to accept submissions
Place the tag,  anywhere in the wiki where you would like to accept submissions for an activity which is to be Peer Evaluated. The submissions need to be a URL to a blog page/wiki page. Please specify this to your learners so that they can put whatever are the deliverables for an activity at a blog post where everyone else can see it and go on to evaluate. This can be a part of some page with some content as well. You will just need to make sure two submitactivity tags are not placed on the same page.

User experience
The tag inserts a web form which allows a registered wiki user to submit an activity and opt in for peer evaluation. Following is a snapshot of the same.

Tag for displaying submissions available for evaluation
To accept evaluations on a wiki page, place the following tag on the page where you would want to accept the submissions, 

User experience

 * This tag renders a table which consists of submissions that are available for evaluation.
 * This is only visible to a logged in wiki user and the tag automatically displays an error message if the user is not logged in.
 * The learner then needs to click on the title of a post that he wants to evaluate.
 * This displays a form which needs to be filled, in order to submit an evaluation.

Viewing submitted evaluations
The following tag can be used to view the submitted evaluations. 

User experience

 * The tag renders a table which consists of the evaluations submitted for an activity.
 * The titles are clickable and doing so lets one view the complete details about an evaluation.

An example
Suppose I want to add Peer evaluation for assignment 1 of the wikieducator AST1000 course.

Note: The example below is deployed at a Beta wikieducator installation ( Details ). But, this guide is applicable to any wiki where the Peer Evaluation extension is installed.

Now, in this example I want to make it absolutely seamless for a learner so that he finds everything relevant to Peer evaluation in the assignment page itself.

So, we have the page - http://b.wikieducator.org/User:Akashagarwal/Assignment_1 with details about the assignment and place all required Peer evaluation content here itself. This implies adding the tags to the content of this page.

Firstly we need to create a rubric page and a submissions page.

Activity submissions page
We create a subpage of this assignment page here for this purpose - http://b.wikieducator.org/User:Akashagarwal/Assignment_1/submissions and place the following content on it:

This page is created and updated automatically. Do not manually edit it.
So, our url for the Activity page, urlofActivities is User:Akashagarwal/Assignment_1/submissions

Rubric page
We may want to incorporate the rubric at http://b.wikieducator.org/User:Akashagarwal/Assignment_1#Marking_rubric for this purpose. But, for this example we use a small part of this rubric.

Firstly create a rubric page - http://b.wikieducator.org/User:Akashagarwal/Assignment_1/rubric

Now, we go to the edit option and place the following Analytic rubric.


 * Assignment 1
 * Clear statement of argument


 * Has a clear and well-integrated sense of argument that flows through the entire paper. This includes argument being directly referred to in the main body.


 * Has some type of statement of argument in the introduction and conclusion, but reference to the argument in the main body is vague.


 * Does not appear to contain any clear argument, either in the introduction/conclusion or the main body.
 * Academic writing style


 * Clear, precise and elegant. Demonstrates a command over the essay format through the use of language that is simple and effective.


 * Satisfactory, though use of language unclear at times and/or relies on rhetorical devices


 * Bears little resemblance to the expected essay format, such as the use of bullet points and over-reliance on direct quotations.
 * Overall structure and conclusion


 * Demonstrates a clear and elegant progression between the substantive points made. The supportive points are grouped logically, and there are ‘signposts’ that explain the links inside and between the substantive points being made.


 * Generally has a clear relationship between the substantive points, though makes some structural errors in ordering the information, and/or may lack clear links between the sections.


 * Contains no discernible structure, and lacks a delineated approach to the material presented.
 * Clear, grammatically correct, written expression


 * Very few (if any) grammatical errors. The meaning of each sentence is always clear and easily understood.


 * Some grammatical errors. Generally the meaning of what is written is clear.


 * Numerous grammatical errors are present, and this affects the ability to understand the meaning of what is said.

So, our url for the rubric page, urlofRubric is User:Akashagarwal/Assignment_1/rubric

Place the submitactivity, evaluation and viewevaluations tag
In this example we want to provide learners everything in a single page. So, we add the following tags to the Assignment 1 page.

  

To do this we edit the Assignment 1 page - http://b.wikieducator.org/User:Akashagarwal/Assignment_1 and add the following content to it

Make a submission for the assignment


View submissions
View all submissions for this assignment by going to http://b.wikieducator.org/User:Akashagarwal/Assignment_1/submissions.

Do an evaluation


All evaluations
You may need to refresh, to get an evaluation you just did.

<viewevaluations activity="User:Akashagarwal/Assignment_1/submissions" />

Now you can go to the page http://b.wikieducator.org/User:Akashagarwal/Assignment_1 and submit activities for evaluation, view submissions available for evaluation, evaluate some submissions and view the evaluations.

You may try out this example by creating sub pages to your user page and tweak around the rubrics, placement of the tags, etc. Please note that the three tags are used in a single page here but it need not be so. You can also have each one on a separate page or two of them on a page. But, you cannot have two instances of the same tag in the same page.

Another similar example for feedback on content using peer evaluation
http://b.wikieducator.org/User:Akashagarwal/contentReview