General contest description
---------------------------

The :file:`contest.yaml` file is a plain YAML file, with at least the following keys.

- ``nome_breve`` ("short name", string): the contest's short name, used for internal reference (and exposed in the URLs); it has to match the name of the directory that serves as contest root.

- ``nome`` ("name", string): the contest's name (description), shown to contestants in the web interface.

- ``problemi`` ("tasks", list of strings): a list of the tasks belonging to this contest; for each of these strings, say :samp:`{task_name}`, there must be a file named :file:`{task_name}.yaml` in the contest directory and a directory called :file:`{task_name}`, used to extract information about that task; the order in this list will be the order of the tasks in the web interface.

- ``utenti`` ("users", list of associative arrays): each of the elements of the list describes one user of the contest; the exact structure of the record is described :ref:`below <externalcontestformats_user-description>`.

The following are optional keys.

- ``inizio`` ("start", integer): the UNIX timestamp of the beginning of the contest (copied in the ``start`` field); defaults to zero, meaning that contest times haven't yet been decided.

- ``fine`` ("stop", integer): the UNIX timestamp of the end of the contest (copied in the ``stop`` field); defaults to zero, meaning that contest times haven't yet been decided.

- ``token_*``: token parameters for the contest, see :ref:`configuringacontest_tokens` (the names of the parameters are the same as the internal names described there); by default tokens are disabled.

- ``max_*_number`` and ``min_*_interval`` (integers): limitations for the whole contest, see :ref:`configuringacontest_limitations` (the names of the parameters are the same as the internal names described there); by default they're all unset.