From 6d80875cd1c3a36f0d6dcc7c582bcfa6b3d70e3a Mon Sep 17 00:00:00 2001 From: Martin Polanka Date: Mon, 16 Jan 2017 23:17:17 +0100 Subject: [PATCH] exercise creation --- Rewritten-docs.md | 64 ++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 58 insertions(+), 6 deletions(-) diff --git a/Rewritten-docs.md b/Rewritten-docs.md index 2f95fba..d63877b 100644 --- a/Rewritten-docs.md +++ b/Rewritten-docs.md @@ -2022,7 +2022,7 @@ As a supervisor of group you are able to see "Edit group settings" button at the top of the page. Following this link will take you to group editation page with form containing these fields: -- group name which is be visible to other users +- group name which is visible to other users - external identification which may be used for ID from school system - description of group which will be available to users in instance (in Markdown) @@ -2148,11 +2148,63 @@ 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 +First form is located in "Edit exercise settings" and generally contains meta +information needed by frontend which are somehow somewhere visible. In here you +can define: + +- exercise name which will be visible to other supervisors +- difficulty of exercise (easy, medium, hard) +- description which will be available only for visitors, may be used for further + description of exercise (for example information about test cases and how they + could be scored) +- private/public switch, if exercise is private then only you as author can see + it, assign it or modify it +- subform containing localized descriptions of exercise, new one can be added + with "Add language variant" button and current one deleted with "Remove this + language" + - language in which this particular description is in (czech, english, + german) + - actual localized description of exercise + +After all information is properly set form has to be submitted with "Edit +settings" button. + +Management of supplementary files can be found in "Supplementary files" box. +Supplementary files are files which you can use further in job configurations +which have to be provided in all runtime configurations. These files are +uploaded directly to fileserver from where worker can download them and use +during execution according to job configuration. + +Files can be uploaded either by drag and drop mechanism or by standard "Add a +file" button. In opened dialog window choose file which should be uploaded. All +chosen files are immediatelly uploaded to server but to save supplementary files +list you have to hit "Save supplementary files" button. All previously uploaded +files are visible right under drag and drop area, please note that files are +stored on fileserver and cannot be deleted after upload. + +The last form on exercise editation page is runtime configurations editation +form. Exercise can have multiple runtime configurations according to the number +of programming languages in which it can be run. Every runtime configuration +corresponds to one programming language because all of them has to have a bit +different job configuration. + +New runtime configuration can be added with "Add new runtime configuration" +button this will spawn new tab in runtime configurations box. In here you can +fill following: + +- human readable identifier of runtime configuration +- runtime environment which corresponds to programming language +- job configuration in YAML, detailed description of job configuration can be + found further in this chapter in "Writing job configuration" section + +If you are done with changes to runtime configurations save form with "Change +runtime configurations" button. If you want to delete some particular runtime +just hit "Remove" button in the right tab, please note that after this operation +runtime configurations form has to be again saved to apply changes. + +All runtime configurations which was added to exercise will be visible to +supervisors and all can be used in assignment, so please be sure that all of the +languages and job configurations are working. 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