Skip to content

docs: realign the roadmap on the ADRs#70

Merged
chuckwondo merged 5 commits into
mainfrom
docs/roadmap-realignment
Jul 17, 2026
Merged

docs: realign the roadmap on the ADRs#70
chuckwondo merged 5 commits into
mainfrom
docs/roadmap-realignment

Conversation

@chuckwondo

Copy link
Copy Markdown
Contributor

The CoverageJSON Trajectory domain requires a t coordinate, so /trajectory is a temporal verb, and the non-temporal multi-position capability is MultiPoint via /position with a MULTIPOINT geometry. ADR-0005 records that and amends ADR-0004.

That leaves the roadmap describing a plan the ADRs and milestones have superseded, so it is retired additively: the stories stay as the historical record, with a table mapping each of the 13 to its current home.

Reconciling the rest turned up stale status claims in docs 01, 02, and 08, and a README that listed /position as planned though it shipped in #44. Each now points at one source of truth rather than keeping its own copy.

A CoverageJSON Trajectory requires a `t` coordinate in every
composite tuple, so a spatial-only path is a MultiPoint coverage,
not a Trajectory. That makes /trajectory a temporal verb, and
MultiPoint the non-temporal multi-position capability, served by
the EDR Position verb (/position accepting a MULTIPOINT).

Record the decision in ADR-0005, amend ADR-0004 (which had listed
/trajectory among the non-temporal verbs), and index it.
Doc 02's banner listed point, transect, tile, time series, and
info as "not yet redesigned": point shipped as /position (#44),
tile is dropped (ADR-0004), and transect is reclassified as the
temporal /trajectory (ADR-0005). Record where each stands, and
flag the /transect example as a schema-invalid Trajectory (its
tuples lack `t`).

Doc 08 kept a second copy of the same status and had drifted the
same way; point it at doc 02's banner instead.
ADR-0004 dropped Story 7 (/tiles) and ADR-0005 reclassifies Story
6 (transect) as temporal; the live plan is now the milestones and
the ADRs, not this file.

Retire it additively: keep the stories as the historical record,
add a table mapping each of the 13 to its current home, lead the
banner with the retirement, and drop the stale promise that the
roadmap "will be re-planned".

Note the same in ADR-0001, appended to its Status since the ADR
corpus is append-only.
Two of Section 3's seven query patterns are now decided elsewhere:
tile is dropped (ADR-0004) and transect is the temporal
/trajectory (ADR-0005). Name both in the banner and point onward
to the ADRs and the README rather than restating a status here,
which is how doc 08's copy drifted.

Mark the roadmap retired in the document-set index.
/position shipped in 52f721b (#44), but the status section listed
point as planned and /bbox as the only slice. List /position, and
rewrite the planned line to what is actually outstanding: area and
multi-position (#56, #65), and temporal extraction.

Mark the linked roadmap as retired.
@chuckwondo
chuckwondo force-pushed the docs/roadmap-realignment branch from 9fd294c to b2366f4 Compare July 17, 2026 10:29
@chuckwondo
chuckwondo merged commit 6fd1d08 into main Jul 17, 2026
12 checks passed
@chuckwondo
chuckwondo deleted the docs/roadmap-realignment branch July 17, 2026 10:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants