Menu
▾
▴
[WWcvs] webwork-modperl: "improved" the help files -- Mike
|
From: Mike G. v. a. <we...@ma...> - 2007-10-11 01:12:33
|
Log Message:
-----------
"improved" the help files
-- Mike
Tags:
----
rel-2-4-dev
Modified Files:
--------------
webwork-modperl/htdocs/helpFiles:
InstructorScoring.html
InstructorUserList.html
instructor_links.html
Revision Data
-------------
Index: InstructorUserList.html
===================================================================
RCS file: /webwork/cvs/system/webwork-modperl/htdocs/helpFiles/InstructorUserList.html,v
retrieving revision 1.3.4.1
retrieving revision 1.3.4.2
diff -Lhtdocs/helpFiles/InstructorUserList.html -Lhtdocs/helpFiles/InstructorUserList.html -u -r1.3.4.1 -r1.3.4.2
--- htdocs/helpFiles/InstructorUserList.html
+++ htdocs/helpFiles/InstructorUserList.html
@@ -52,7 +52,7 @@
<dd> Click the "Add x student(s)" radio button and then click "Take action". This will take you to a new page where the data can be entered for one or more students. It is also possible to assign the student to one or more problem sets as they are being entered: simply select the homework sets from the list below the data entry table. Use 'command' or 'control' click to select more than one homework set.</dd>
<dt>Add many students to a course from a class list.</dt>
- <dd>This is most easily done by importing a class list. The class list can be uploaded from your workstation to the server using the File Manager page. The class list must be a file ending in .lst and must have a specific <a href="http://webhost.math.rochester.edu/webworkdocs/discuss/msgReader$59#2397">format</a>. Once the file has been uploaded to the server the file will appear in the import action pop-up list (5th action). demoCourse.lst is available for most courses and adds the "practice users" which activate guest logins to the class list .</dd>
+ <dd>This is most easily done by importing a class list. The class list can be uploaded from your workstation to the server using the File Manager page. The class list must be a file ending in .lst and must have a specific <a href="http://devel.webwork.rochester.edu/twiki/bin/view/Webwork/ClasslistFileFormat">format</a>. Once the file has been uploaded to the server the file will appear in the import action pop-up list (5th action). demoCourse.lst is available for most courses and adds the "practice users" which activate guest logins to the class list .</dd>
<dt>Add a TA or an instructor (change permission level of user)</dt>
<dd>This is done by first entering the user as a student and then changing the permission level of the user. First edit the user by clicking on the pencil next to their name (or using the technique above for several users), then change their permssion level -- an entry blank at the far right of the screen, you may have to scroll to see it. The permission levels are
Index: instructor_links.html
===================================================================
RCS file: /webwork/cvs/system/webwork-modperl/htdocs/helpFiles/instructor_links.html,v
retrieving revision 1.5.4.1
retrieving revision 1.5.4.2
diff -Lhtdocs/helpFiles/instructor_links.html -Lhtdocs/helpFiles/instructor_links.html -u -r1.5.4.1 -r1.5.4.2
--- htdocs/helpFiles/instructor_links.html
+++ htdocs/helpFiles/instructor_links.html
@@ -27,9 +27,12 @@
<h3>Instructor Links Help Page</h3>
-Click the icon <a href="instructor_links.html"><img src="/webwork2_files/images/question_mark.png"></a> for
-page and item specific help.
+<hr/>
+<b>For help with an item on a specific page</b><br/>
+click the <a href="instructor_links.html"><img src="/webwork2_files/images/question_mark.png"></a> icon.
+
+<hr/>
<dl>
<dt>Instructor Tools</dt>
<dd>Quick access to many instructor tools, including
Index: InstructorScoring.html
===================================================================
RCS file: /webwork/cvs/system/webwork-modperl/htdocs/helpFiles/InstructorScoring.html,v
retrieving revision 1.2.4.1
retrieving revision 1.2.4.2
diff -Lhtdocs/helpFiles/InstructorScoring.html -Lhtdocs/helpFiles/InstructorScoring.html -u -r1.2.4.1 -r1.2.4.2
--- htdocs/helpFiles/InstructorScoring.html
+++ htdocs/helpFiles/InstructorScoring.html
@@ -21,8 +21,76 @@
</head>
<body><br>
-<p>The files created by this page contain all the scoring data in a comma delimited file. This file can easily be opened by a
-spreadsheet program. To download the file after it's been created click on the link below, or go to the file transfer page
-where scoring files may also be downloaded.</p>
+
+<p>
+WeBWorK does not have a full featured scoring ability -- we leave that to your
+favorite spread sheet application.
+</p>
+
+<p>
+What WeBWorK does have is good support for summarizing the scores on WeBWorK
+homework sets and exporting them in a form (.csv) which any spreadsheet can use.
+WeBWorK reports all of the homework grades,
+creates a column which totals these grades and leaves it at that.
+</p>
+
+<p>
+Click on the sets you want scored (usually all of them :-) )
+choose the name of the export file you want to
+use (by default: courseName_totals.csv) and then click the
+"score selected sets" button.
+</p>
+
+<p>
+If you want a form that is easy to read on the web (for a quick look at grades)
+click the "pad fields" option. This adds spaces the fields which makes the
+columns easy to read when in text form but it can confuse
+some spread sheet applications since the extra spaces violate the csv standard
+(although Excel handles them with no problem). If you want a reliable .csv file
+for use in any spreadsheet application unclick the "pad fields" option.
+You can download the .csv file immediately by clicking on the link, or you
+can download it using the "File Manager" from the scoring directory.
+</p>
+
+<p>
+I have no clue what "record scores for single sets" does -- sorry.
+</p>
+
+<p>
+The index is a number assigned on the basis of the number of incorrect attempts
+(roughly equivalent to 1/the number of attempts) which seems to correlate with
+the relative difficulty the student had with the problem.
+</p>
+
+<p>
+We would all like to be able to merge the spreadsheet with the webwork grades
+and a spread sheet with the excel grades automatically. Unfortunately this
+application has not yet been written for WeBWorK and for that matter it doesn't
+appear to be an ability that Excel has either. The closes I have been able
+to find is third party software for excel (e.g. http://www.synkronizer.com/e/tutorial_merging.html)
+</p>
+
+<p>
+To use the Email and spreadsheet merge feature, upload your spreadsheet with
+calculated grades to the scoring directory using the File Manager link.
+</p>
+
+<p>
+Do NOT use the file name courseName_totals.csv, since you might accidentally
+overwrite that if you again export your WeBWorK homework scores (actually the
+earlier file is moved to courseName_totals_bak1.csv -- so you can recover
+using the File Manager -- but it's still a pain).
+</p>
+
+<p>
+If you upload your file on the web with the name: <code>report_grades_data.csv</code>
+and also create an email message with the name <code>report_grade.msg</code> with the
+approriate <code>$COL</code> variables then not only can you email the message
+with the embedded grades to the students, but files with those exact names are
+automatically appended to the "Grades" page seen by the students.
+</p>
+
+
+
</body>
</html>
|
