Skip to content

Commit f93078d

Browse files
committed
Reformat and extend explanation
1 parent dcd2f4e commit f93078d

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
@@ -1455,21 +1455,22 @@ The following endpoints are associated with state:
14551455

14561456
Properties of state objects:
14571457

1458-
| Name | Type | Description
1459-
| :--------------- | :----- | :----------
1460-
| 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`.
1461-
| 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.
1462-
| ended | TIME ? | Time when the contest ended, or `null` if the contest has not ended. Must not be set if started is `null`.
1463-
| 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`.
1464-
| finalized | TIME ? | Time when the results were finalized, or `null` if results have not been finalized. Must not be set if ended is `null`.
1465-
| 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.
1458+
| Name | Type | Description
1459+
| :----------------- | :------------------ | :----------
1460+
| 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`.
1461+
| 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.
1462+
| ended | TIME ? | Time when the contest ended, or `null` if the contest has not ended. Must not be set if started is `null`.
1463+
| 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`.
1464+
| finalized | TIME ? | Time when the results were finalized, or `null` if results have not been finalized. Must not be set if ended is `null`.
1465+
| 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.
14661466
| removed\_intervals | array of INTERVAL ? | Array of [removed time intervals](ccs_system_requirements#removing-time-intervals).
14671467

14681468
These state changes must occur in the order listed in the table above,
14691469
as far as they do occur, except that `thawed` and `finalized` may occur
1470-
in any order. For example, the contest may never be frozen and hence not
1471-
thawed either, or, it may be finalized before it is thawed. That, is the
1472-
following sequence of inequalities must hold:
1470+
in any order. `removed_intervals` is not a state change, and so is not affected
1471+
by this requirement. For example, the contest may never be frozen and hence not
1472+
thawed either, or, it may be finalized before it is thawed. I.e. the following
1473+
sequence of inequalities must hold:
14731474

14741475
```
14751476
started < frozen < ended < thawed < end_of_updates,

0 commit comments

Comments
 (0)