documentation/content/applications/marketing/surveys/overview/time_random.rst
Antoine Vandevenne (anv) 8722ea902e [MOV] content/*: move resource files into their related page's directory
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
2022-05-20 14:18:54 +02:00

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`