diff --git a/Rewritten-docs.md b/Rewritten-docs.md index 3c28da2..2f95fba 100644 --- a/Rewritten-docs.md +++ b/Rewritten-docs.md @@ -2078,9 +2078,9 @@ In meta information form you can fill these options: language" button) - language of description from dropdown field (english, czech, german) - description in selected language -- score configuration which will be used on students solution evaluation, - description of score configuration can be found further in "Writing score - configuration" chapter +- score configuration which will be used on students solution evaluation, you + 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 - second submission deadline, after that students still can submit exercises but @@ -2136,7 +2136,30 @@ who else can see the comments -- same as from the student perspective ### Creating exercises -@todo: how to create exercise, what has to be provided during creation, who can create exercises +Link to exercise creation can be found in exercises list which is accessible +through "Exercises" link in sidebar. On the bottom of the exercises list page +you can find "Add exercise" button which will redirect you to exercise editation +page. In this moment exercise is already created so if you just leave this page +exercise will stay in the database. This is also reason why exercise creation +form is the same as the exercise editation form. + +Exercise editation page is divided into three separate forms. First one is +supposed to contain meta information about exercise, second one is used for +uploading and management of supplementary files and third one manages runtime +configuration in which exercise can be executed. + +@todo: exercise desc + +@todo: supplementary files + +@todo: runtime configs + +If you choose to delete exercise, at the bottom of the exercise editation page +you can find "Delete the exercise" box where "Delete" button is located. By +clicking on it exercise will be delete from the exercises list and will no +longer be available. + +### Exercise's reference solutions @todo: Describe the form and explain the concept of reference solutions. How to evaluate the reference solutions for the exercise right now (to @@ -2188,9 +2211,39 @@ anymore. ## Instance administrator -@todo: who is this? +Administrator of instance can be only one per instance. In addition to previous +roles instance admin should be able to modify instance details, manage licences +and take care of groups which belong to instance. + +### Instance management + +List of all instances in system can be found under "Instances" link in sidebar. +On the mentioned page there is a table of instances with their respective +admins. If you are admin of one of them you can visit its page by clicking on +the instance name. On instance details page you can find some description of +instance, current groups hierarchy and form for creating new group. + +If you want to change some of the instance settings follow "Edit instance" link +on instance details page. This will take you to instance editation page with +corresponding form. In there you can fill following information: + +- name of the instance which will be visible to every other user +- brief description of instance and for whom it is intended +- checkbox if instance is open or not which means public or private (hidden from + potentional users) + +If you are done with editation, save filled information by clicking on "Update +instance" button. + +If we go back to the instance details page you can find here "Create new group" +box which is able to add group to instance. This form is the same as the one for +creating subgroup in already existing group so we can skip description of form +fields. After successful creation of group it should appear in "Groups +hierarchy" box at the top of the page. + +### Licenses -@todo: creating groups right in the instance +@todo: licenses ## Superadministrator