Updated FAQ (markdown)

master
Martin Kruliš 5 years ago
parent baa17a2c29
commit 2f55093fad

@ -30,14 +30,6 @@ User can create local account in the profile **Settings** page. In here if you a
The system's login mechanism is prepared for this option. The only prerequisite is that your email address in the local account must be the same as the one in CAS. If this is the case, binding the accounts is quite easy, just log in using CAS and the system will automatically bind those two accounts. Also please note that when binding your local account your password will be cleared and if you want to use it further, you have to change it. The system's login mechanism is prepared for this option. The only prerequisite is that your email address in the local account must be the same as the one in CAS. If this is the case, binding the accounts is quite easy, just log in using CAS and the system will automatically bind those two accounts. Also please note that when binding your local account your password will be cleared and if you want to use it further, you have to change it.
## C# Reader
In **C#** language there are none of the handy functions to operate with textual inputs like _scanf_ in **C**. Therefore for every C# build in ReCodEx there is [Reader.cs](https://github.com/ReCodEx/utils/blob/master/runners/cs/Reader.cs) library included to make life of C# programmers easier. Please note that library is suppose to work only with ASCII files and some difficulties can be observed with modern Unicode (UTF-8) encodings.
## Exit Codes
For some particular languages ReCodEx provides mappings of exit codes from internal runners to messages. Full tables of codes can be found on [separate page](https://github.com/ReCodEx/wiki/wiki/Exit-Code-Mappings).
## Exercise vs. Assignment ## Exercise vs. Assignment
Exercise and assignment are two terms which are not the same and there are some differences. In general, **exercises** are templates for **assignments**. In more detail, exercises are algorithmic problems defined and configured by supervisors. Exercise contains test cases which executes solutions submitted by users and check their outputs against sample results. Configuration of an exercise also defines time and memory limits which the solution has to meet and scoring details which are used in the evaluation (assigning points for passed tests). Exercise itself cannot be solved by students and is displayed only to supervisors and administrators. Exercise and assignment are two terms which are not the same and there are some differences. In general, **exercises** are templates for **assignments**. In more detail, exercises are algorithmic problems defined and configured by supervisors. Exercise contains test cases which executes solutions submitted by users and check their outputs against sample results. Configuration of an exercise also defines time and memory limits which the solution has to meet and scoring details which are used in the evaluation (assigning points for passed tests). Exercise itself cannot be solved by students and is displayed only to supervisors and administrators.
@ -46,6 +38,16 @@ If supervisor assigns an exercise to a group of students, an assignment is creat
When the assignment gets out of sync with its original exercise (because the exercise was edited), a informational panel is displayed to the supervisor on the assignment detail/edit page. This panel also hold a button, which allows the supervisor to overwrite current assignment data (text, configuration, limits, ...) with the current version of the exercise. When the assignment gets out of sync with its original exercise (because the exercise was edited), a informational panel is displayed to the supervisor on the assignment detail/edit page. This panel also hold a button, which allows the supervisor to overwrite current assignment data (text, configuration, limits, ...) with the current version of the exercise.
## Runtime Environments
Exercises may be configured to support different runtime environments. Runtime environments defines the programming language (i.e., compiler) and necessary libraries (like Java RTE or Mono). Assignment may limit, which RTEs are visible, but cannot add additional ones. The actual runtime used for a submission is pre-selected based on submitted files. If the files does not identify RTE uniquely, the submitter may select the actual runtime.
Some runtimes have specific nuances. The details (useful both for students and for supervisors) are on a [separate page](https://github.com/ReCodEx/wiki/wiki/Runtime-Environments).
For some particular languages ReCodEx provides mappings of exit codes from internal runners to messages. Full tables of codes can be found on [separate page](https://github.com/ReCodEx/wiki/wiki/Exit-Code-Mappings).
## As a supervisor I want to see more detailed logs of user submissions ## As a supervisor I want to see more detailed logs of user submissions
Before we start let us define **debug** vs. **normal** submissions. The results of a debug submission contain evaluation results, the execution log and the outputs of executed programs. And the results of a normal submission contain only the results needed for proper assignment of points (aka. evaluation results). Before we start let us define **debug** vs. **normal** submissions. The results of a debug submission contain evaluation results, the execution log and the outputs of executed programs. And the results of a normal submission contain only the results needed for proper assignment of points (aka. evaluation results).

Loading…
Cancel
Save