diff --git a/guide/src/main/asciidoc/changelog.adoc b/guide/src/main/asciidoc/changelog.adoc index 7356289..5b1de93 100644 --- a/guide/src/main/asciidoc/changelog.adoc +++ b/guide/src/main/asciidoc/changelog.adoc @@ -1,4 +1,11 @@ == Changelog +* 2024-01-31 +** new: a document may also be a singleton that's not part of a collection (<>) +** new: path parameter names should use lowerCamelCase <> +** update: clarify that query parameters should use lowerCamelCase <> +** update: the name of a multi-value query parameter should be singular if it's a noun <> +** new: explicit rule and clearer guidelines on `GET /health` resource <> + * 2023-10-05 ** update: <> issue type for unknown input is renamed ** new: rule <> on case-insensitivity of HTTP headers diff --git a/guide/src/main/asciidoc/index.adoc b/guide/src/main/asciidoc/index.adoc index 136ff12..1f334ce 100644 --- a/guide/src/main/asciidoc/index.adoc +++ b/guide/src/main/asciidoc/index.adoc @@ -1,4 +1,4 @@ -:update-date: 2023-10-05 +:update-date: 2024-01-31 :doctype: book :docinfo: :toc: left diff --git a/guide/src/main/asciidoc/resources-document.adoc b/guide/src/main/asciidoc/resources-document.adoc index 68bebc7..8b38260 100644 --- a/guide/src/main/asciidoc/resources-document.adoc +++ b/guide/src/main/asciidoc/resources-document.adoc @@ -26,6 +26,7 @@ a| |`/persons/{ssin}` ==== +[[document-singleton, Singleton documents]] *Singleton documents* Documents may also be _singletons_, of which only a single instance exists within the context of its parent, if any. A singleton document's URI ends with a *fixed path segment that is a singular noun*.