Changes between Version 1 and Version 2 of UserDocV3.1


Ignore:
Timestamp:
2013-05-03T00:09:34Z (11 years ago)
Author:
michael
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • UserDocV3.1

    v1 v2  
    99iPeer is a Web Application. This means that it runs on a server, and can be accessed with any web browser.[[br]]
    1010iPeer is written in a web programming language called PHP (http://www.php.net) and uses an application framework called CakePHP. (http://www.cakephp.org) to structure its code.
    11 For more technical details, please see iPeer's Trac website at http://ipeer.ctlt.ubc.ca/trac/
     11For more technical details, please see iPeer's Trac website at http://ipeer.ctlt.ubc.ca/
    1212
    1313There are 5 types of users in iPeer: students, tutors, instructors, faculty administrators, and administrators.
     14
     15=== Students ===
     16The students interface is focused on completing evaluations. After students have been created they can log into the system, and after they have been assigned to courses they can complete evaluation events and surveys.
     17
     18==== Login for Students ====
     19Students can log in via 2 mechanisms:
     20 * via username and password, like every other type of iPeer user.
     21 * via the CWL plug-in (for University of British Columbia (UBC)).
     22  * Note that if CWL plug-in is enabled, the students cannot login via iPeer's username and password, and must always use their CWL login.
     23
     24===== iPeer Login for Students =====
     25The students login with their username and password.
     26 * Username: enter your student number.
     27 * Password: enter the password given to you by your instructor or TA. You can update your password later.
     28Click the login button to complete the login process.
     29
     30===== CWL Login for UBC Students =====
     31Click on the CWL logo at the login screen, and you will be taken to the UBC CWL login page. Login like you do for other UBC pages, and after the login is complete, you'll be taken iPeer Home.
     32* Please note that if you use your CWL login, changing your password in iPeer will have no effect on your CWL password.
     33
     34==== Home Page ====
     35When a students logs in, they are presented with the home page. Student's view of iPeer is focused on submitting evaluations assigned by their instructors.[[br]]
     36This page contains 5 sections, listing evaluation events:
     37
     38===== Peer Evaluations Due =====
     39
     40These are the evaluations that should be completed. Example:
     41
     42||'''Event'''||'''Group'''||'''Course'''||'''Due Date'''||'''Due In / Late By'''||
     43||Evaluation 2||Unnamed||COMP 101 101||Sun, Sep 5, 2010 11:55 am||30.2 days||
     44
     45To complete an evaluation, just click on its title. So, to complete the above event, you would click on "Evaluation 2".
     46
     47===== Peer Evaluations Submitted =====
     48
     49These evaluations were already completed. Example:
     50
     51||'''Event'''||'''Viewable Start / End'''||'''Group'''||'''Course'''||'''Due Date'''||'''Date Submitted'''||
     52||Evaluation 1||2013-01-01 00:00:00||Unnamed||COMP 101 101||Tues,Jan 1,2012 12:00 am||2012-11-23 12:24:51||
     53
     54If the "Viewable Start / End" date is coloured
     55 * ''red'', the name of the event is a link to the previously submitted evaluation, allowing students to change their submission.
     56 * ''black'', the name of the event is a link to the evaluation answers and results (if they were released by the instructor).
     57
     58If the name of the event is not a link, the event has ended (no more submissions can be made) and the results are not viewable yet.
     59
     60===== Peer Evaluations Expired With No Submission =====
     61
     62These evaluations have expired and have not been completed. Example:
     63
     64||'''Event'''||'''Viewable Start / End'''||'''Group'''||'''Course'''||'''Due Date'''||
     65||Evaluation 3||2013-01-01 00:00:00||Unnamed||COMP 101 101||Tues,Dec 25,2012 12:00 am||
     66
     67If the name of the event is a link, results are viewable
     68
     69===== Surveys Due =====
     70
     71These are the surveys that should be completed. Example:
     72
     73||'''Event'''||'''Course'''||'''Due Date'''||'''Due In / Late By'''||
     74||Survey 1||COMP 101 101||Tues,Jan 8,2013 12:00 pm||6 days||
     75
     76To complete a survey, just click on its title. So, to complete the above survey, you would click on "Survey 1".
     77
     78===== Surveys Submitted =====
     79
     80These surveys were already completed. Example:
     81
     82||'''Event'''||'''Course'''||'''Due Date'''||'''Date Submitted'''||
     83||Survey 2||COMP 101 101||Tues,Jan 1, 2013 12:00 pm||2012-12-25 11:37:17||
     84
     85The name of the event is a link to the answers submitted.
     86
     87==== Filling out Evaluations ====
     88
     89There are 3 types of evaluations in iPeer: Simple Evaluations, Rubrics, and Mixed evaluations.
     90After clicking on an evaluation name, the selected evaluation will open.
     91
     92===== Simple Evaluations =====
     93[[Image(simple_evaluation.png, 240px, align=right, border=3)]] 
     94Simple evaluations are the most basic evaluation types in iPeer. They consist of a set number of points to distribute among your team members.
     95The following instructions appear on the evaluation page itself:
     96
     97 1. Rate your peer's relative performance by using the slider. [Weight 1-10]
     98  * iPeer has a semi-automatic system for distributing points with amongst your team members. Slide each of the orange sliders to evaluate your team members relative to one-another. This will assign them "slider-points".
     99 2. Click "Distribute" button to distribute points.
     100  * iPeer will calculate the percentage of "slider-points" you assigned to each of your teammates, and will then calculate how many real points each is given. For example, the evaluation has 200 Real Points to distribute amongst your 4 teammates. You assign them "relative score" of 8 for each. You then click distribute. The total number of "relative scores" will be 32. Each member has 8 relative points, their will all get 8/32*100% = 25% of the total real score. In real score, each member will get 200 Points * 25% = 50 points / member.
     101  * The above situation would repeat itself if you assigned '''each''' member a slider score, of 2, or 4, or 6, or anything else. Since the number of "relative points" you gave to each member mains equal, they will all be equal relative to one another. It is only the real score for each member that counts.
     102  * Quick note: If the above info is confusing, then simply forget about the sliders and Distribute button! Instead, enter the number of points you would like to give to each teammate manually, fill out the comments, and submit your evaluation. Make sure that the points add up to the total number of points to distribute. This is explained in point 3, below.
     103 3. Allocate any remaining points.
     104  * This step usually occurs in cases where the "Distribute" button could not allocate all the points exactly according to your relative scores.
     105  * For example, if you relative-scored all your three teammates equally, and the number of total points is 100, the real points cannot be equally divided! Each member would get 33 points, and 33+33+33 = 99, with one real point left to distribute. To distribute this point, you would give one of your team members a score of 34 manually. That way, the total real score would be '''34''' + 33 + 33 = 100, and all points would be distributed.
     106  * If "Distribute" button succeeded in giving everyone a fair score, or if you distributed all the points yourself, this step is unnecessary.
     107 4. Enter Comments
     108  * You may always enter a comment. Some instructors will ''require'' you to enter comments, and ''others will not''. Whatever the case might be, please remember that explaining the reasons behind your evaluation of your team-mates is always a good idea!
     109 5. NOTE: "Submit Evaluation" button will only be enabled when all points are distributed, and comments (if required) are filled!
     110  * Before you submit:
     111   * Look over your scores one more time.
     112   * Check that you entered all the comments that you like, or are required to.
     113  * If the Submit button is grayed out, something is likely missing. Check the comments and total number of real points once again.
     114 6. (Show / Hide late penalty policy)
     115  * If the evaluation has a late penalty, details can be found here.
     116  * If there are no late penalty, "No penalty is specified for this evaluation" will appear.