diff --git a/docs/ocis/adr/0011-global-url-format.md b/docs/ocis/adr/0011-global-url-format.md index cc9d432420..ce46f32236 100644 --- a/docs/ocis/adr/0011-global-url-format.md +++ b/docs/ocis/adr/0011-global-url-format.md @@ -97,17 +97,18 @@ This ADR is limited to the scope of "how will a web client deal with the browser ## Decision Outcome -Chosen option: "[option 1]", because [justification. e.g., only option, which meets k.o. criterion decision driver | which resolves force force | … | comes out best (see below)]. +Chosen option: "Mixed global URLs", because it meets the requirement to contain a path and a stable identifier. ### Positive Consequences -* [e.g., improvement of quality attribute satisfaction, follow-up decisions required, …] -* … +* The path makes it "human readable" +* The URL can be bookmarked +* The bookmarked URLs remain stable even if the path changes +* All URLs can be shortened to hide any metadata like path, resource name and query parameters ### Negative Consequences -* [e.g., compromising quality attribute, follow-up decisions required, …] -* … +* the web UI needs to look up the space alias in a registry to build an API request for the `/dav/space` endpoint ## Pros and Cons of the Options