Student solution management

.~lock.Rewritten-docs.md#

@@ -1 +0,0 @@
-,petr,felicity,17.01.2017 15:01,file:///home/petr/.config/libreoffice/4;

Rewritten-docs.md

@@ -2088,7 +2088,9 @@ In meta information form you can fill these options:
   can find some very simple one already in here, description of score
   configuration can be found further in "Writing score configuration" chapter
 - first submission deadline
-- maximum gainable points before first deadline
+- maximum gainable points before first deadline; if you want to manage all
+  points manually, set here 0 and then use concept of bonus points, which is
+  described in the next subchapter
 - second submission deadline, after that students still can submit exercises but
   no points for them (must be after the first deadline)
 - maximum gainable points after first deadline and before second deadline
@@ -2127,18 +2129,36 @@ save form with "Change limits" button right under environments box.
 
 ### Students' solutions management
 
-@todo Describe where all the students’ solutions for a given assignment
-can be found, where to look for all solutions of a given student, how to
-see results of a specific student’s solution’s evaluation result.
-
-@todo Can I assign points to my students’ solutions manually instead of depending on automatic scoring? If and how to change the score of a solution – assignment
-settings, setting points, bonus points, accepting a solution (*not
-implemented yet!*). Describe how the student and supervisor will still
-be able to see the percentage received from the automatic scoring, but
-the awarded points will be overridden.
-
-@todo: Describe the comments thread behavior (public/private comments),
-who else can see the comments -- same as from the student perspective
+One of the most important tasks for a group supervisor is checking student
+solutions. As automatic evaluation of them cannot catch all aspects of source
+code, it is suitable to do a brief manual review of student's coding style and
+reflect that in assignment bonus points.
+
+On "Assignment detail" page there is an "View student results" button near top
+of the page (next to "Edit assignment settings" button). This will redirect you
+to a page where is a list of boxes, one box per student. Each student box
+contains a list of submissions for this assignment. The row structure of
+submission list is the same as the structure in student's "Submitted solution"
+box. More information about every solution can be showed by clicking on "Show
+details" link on the end of solution row.
+
+This page is the same as for students with one exception -- there is an
+additional collapsed box "Set bonus points". In unfolded state, there is an
+input field for one number (positive or negative integer) and confirmation
+button "Set bonus points". After filling intended amount of points and
+submitting the form, the data in "Evaluation details" box get immedialely
+updated. To remove assigned bonus points, submit just the zero number. The bonus
+points are not additive, newer value overrides older values.
+
+It is useful to give a feedback about the solution back to the user. For this
+can be nicely used the "Commens and notes" box. Make sure that the messages are
+not private, so the student can see them. More detailed description of this box
+is available in student part of user documentation.
+
+One of the discussed concept was marking one solution as accepted. However, due
+to lack of frontend developers it is not yet prepared in user interface. We
+hope, it will be ready as soon as possible. The button for accepting a solution
+will be most propably also on this page.
 
 ### Creating exercises