Skip to content

Commit 25b8f8b

Browse files
niemelaeldering
authored andcommitted
Reformat and extend explanation
1 parent 125f8c6 commit 25b8f8b

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

Contest_API.md

+12-11
Original file line numberDiff line numberDiff line change
@@ -1461,21 +1461,22 @@ The following endpoints are associated with state:
14611461

14621462
Properties of state objects:
14631463

1464-
| Name | Type | Description
1465-
| :--------------- | :----- | :----------
1466-
| started | TIME ? | Time when the contest actually started, or `null` if the contest has not started yet. When set, this time must be equal to the [contest](#contests) `start_time`.
1467-
| frozen | TIME ? | Time when the scoreboard was frozen, or `null` if the scoreboard has not been frozen. Required iff `scoreboard_freeze_duration` is present in the [contest](#contests) endpoint.
1468-
| ended | TIME ? | Time when the contest ended, or `null` if the contest has not ended. Must not be set if started is `null`.
1469-
| thawed | TIME ? | Time when the scoreboard was thawed (that is, unfrozen again), or `null` if the scoreboard has not been thawed. Required iff `scoreboard_freeze_duration` is present in the [contest](#contests) endpoint. Must not be set if frozen is `null`.
1470-
| finalized | TIME ? | Time when the results were finalized, or `null` if results have not been finalized. Must not be set if ended is `null`.
1471-
| end\_of\_updates | TIME ? | Time after last update to the contest occurred, or `null` if more updates are still to come. Setting this to non-`null` must be the very last change in the contest.
1464+
| Name | Type | Description
1465+
| :----------------- | :------------------ | :----------
1466+
| started | TIME ? | Time when the contest actually started, or `null` if the contest has not started yet. When set, this time must be equal to the [contest](#contests) `start_time`.
1467+
| frozen | TIME ? | Time when the scoreboard was frozen, or `null` if the scoreboard has not been frozen. Required iff `scoreboard_freeze_duration` is present in the [contest](#contests) endpoint.
1468+
| ended | TIME ? | Time when the contest ended, or `null` if the contest has not ended. Must not be set if started is `null`.
1469+
| thawed | TIME ? | Time when the scoreboard was thawed (that is, unfrozen again), or `null` if the scoreboard has not been thawed. Required iff `scoreboard_freeze_duration` is present in the [contest](#contests) endpoint. Must not be set if frozen is `null`.
1470+
| finalized | TIME ? | Time when the results were finalized, or `null` if results have not been finalized. Must not be set if ended is `null`.
1471+
| end\_of\_updates | TIME ? | Time after last update to the contest occurred, or `null` if more updates are still to come. Setting this to non-`null` must be the very last change in the contest.
14721472
| removed\_intervals | array of INTERVAL ? | Array of [removed time intervals](ccs_system_requirements#removing-time-intervals).
14731473

14741474
These state changes must occur in the order listed in the table above,
14751475
as far as they do occur, except that `thawed` and `finalized` may occur
1476-
in any order. For example, the contest may never be frozen and hence not
1477-
thawed either, or, it may be finalized before it is thawed. I.e., the
1478-
following sequence of inequalities must hold:
1476+
in any order. `removed_intervals` is not a state change, and so is not affected
1477+
by this requirement. For example, the contest may never be frozen and hence not
1478+
thawed either, or, it may be finalized before it is thawed. I.e., the following
1479+
sequence of inequalities must hold:
14791480

14801481
```
14811482
started < frozen < ended < thawed < end_of_updates,

0 commit comments

Comments
 (0)