From ffd38dd9706602c66cdadb1e8db409b63c05dcab Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marc=20W=C3=BCrth?= Date: Fri, 23 Jul 2021 12:18:20 +0200 Subject: [PATCH] Links are for navigating resources Links are for navigating to resources, first and foremost. As in URL, Uniform __Resource__ Locator https://en.wikipedia.org/wiki/URL. Likewise, mentioning (navigating between application) state(s) and thus hinting at HATEOAS does not seem to be very relevant here. --- json-home/draft.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/json-home/draft.md b/json-home/draft.md index 6e2c9a01..5a9b330b 100644 --- a/json-home/draft.md +++ b/json-home/draft.md @@ -53,7 +53,7 @@ Often, these applications of HTTP are defined by documenting static URLs that cl For some applications, this approach brings issues, especially when the interface changes, either due to evolution, extension or drift between implementations. Furthermore, implementing more than one instance of interface can bring further issues, as different environments have different requirements. -The Web itself offers one way to address these issues, using links {{!RFC3986}} to navigate between states. A link-driven application discovers relevant resources at run time, using a shared vocabulary of link relations {{!RFC8288}} and internet media types {{!RFC6838}} to support a "follow your nose" style of interaction -- just as a Web browser does to navigate the Web. +The Web itself offers one way to address these issues, using links {{!RFC3986}} to navigate between resources. A link-driven application discovers relevant resources at run time, using a shared vocabulary of link relations {{!RFC8288}} and internet media types {{!RFC6838}} to support a "follow your nose" style of interaction -- just as a Web browser does to navigate the Web. A client can then decide which resources to interact with "on the fly" based upon its capabilities (as described by link relations), and the server can safely add new resources and formats without disturbing clients that are not yet aware of them.