8722ea902e
Since odoo/documentation#903, the guideline for the location of new resource (images, downloadable files, RST includes...) files is to place those inside the directory of the RST page that references them. For example, if `doc1.rst` has a reference to `image.png` and to `download.zip`, the file structure should look like this: ├── parent_doc/ │ └── doc1/ │ │ └── image.png │ │ └── download.zip │ └── doc1.rst │ └── doc2.rst ├── parent_doc.rst Before this commit, most of the resource files were still located inside 'media' directories holding all the resource files referenced by RST pages located at the same level as these directories. In the example above, a single 'media' directory would hold all the resource files referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from figuring out easily which resource file was referenced by which RST page and, thus, lead to unused resource files piling up in the repository. It also made it more complicated to define codeowners regex rules because a team could not simply be assigned to `/some_page.*` but needed to be assigned to both `/some_page\.rst` and to the location of 'media'. In order to help new content writers figure out the guideline when taking examples from other RST pages, this commit retroactively applies the guideline to existing resource files and 'media' directories. The left-over resource files that are not referenced by any RST page are removed. task-2497965 Part-of: odoo/documentation#2068
34 lines
1.3 KiB
ReStructuredText
34 lines
1.3 KiB
ReStructuredText
============================
|
|
Time and Randomize Questions
|
|
============================
|
|
|
|
Time Limit
|
|
==========
|
|
|
|
| On timed surveys, respondents need to complete the survey within a certain period of time. It can
|
|
be used to ensure that all respondents get the same amount of time to find the answers, or to
|
|
decrease the chance of having them looking at external resources.
|
|
| Set the *Time limit* under the tab *Options*.
|
|
|
|
.. image:: time_random/tab_options_timelimit.png
|
|
:align: center
|
|
:alt: View of a survey form emphasizing the time limit feature in Odoo Surveys
|
|
|
|
A timer is shown on the pages so the user can keep track of the remaining time. Surveys not \
|
|
submitted by the *Time limit* do not have their answers saved.
|
|
|
|
Selection
|
|
=========
|
|
|
|
| When you randomize a survey, you allow for the questions to be shuffled in a random order every
|
|
time someone opens the questionnaire. This can be useful to avoid having respondents looking at
|
|
each others' answers.
|
|
| To do so, under the tab *Options*, enable *Randomized per section*. Now, under the tab *Questions*,
|
|
set how many of the questions in that section should be taken into account during the shuffling.
|
|
|
|
.. image:: time_random/random_question.png
|
|
:align: center
|
|
:alt: View of a survey form emphasizing the random questions count column in Odoo Surveys
|
|
|
|
.. seealso::
|
|
- :doc:`scoring` |