Skip to main content

Module timeline

Module timeline 

Source
Expand description

A chronological feed of what happened, and who did it.

§The timeline does not know what time it is

Every time here is a string the caller already formatted, and so is every day heading. Turning an instant into words is calendar, time-zone and locale work: whoever owns the clock owns the wording, and a component that formatted a timestamp itself would be inventing a locale for its host. The adapter that does the formatting sits above this component and hands it finished strings, which is the whole seam.

An entry whose time nobody knows says so. It is not quietly floated to the top or dropped to the bottom, because either would be a claim about when it happened.

Structs§

Timeline
A chronological feed, optionally divided into days.
TimelineEntry
One thing that happened.
TimelineGroup
A run of entries under one heading, usually a day.

Enums§

EntryTime
When an entry happened, as far as anyone knows.