From 3c20170f51f0ffc5923038f65ebd1f2dfa0d9af2 Mon Sep 17 00:00:00 2001 From: Anuraag Agrawal Date: Mon, 9 Nov 2020 05:48:53 +0900 Subject: [PATCH] Use MUST consistently instead of SHALL (#1208) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Use MUST consistently instead of shall. * Update specification/trace/semantic_conventions/messaging.md Co-authored-by: Christian Neumüller Co-authored-by: Christian Neumüller --- specification/baggage/api.md | 8 ++++---- specification/trace/semantic_conventions/messaging.md | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/specification/baggage/api.md b/specification/baggage/api.md index 0b19f583b67..e9183301813 100644 --- a/specification/baggage/api.md +++ b/specification/baggage/api.md @@ -57,7 +57,7 @@ OPTIONAL parameters: ### Get baggage To access the value for a name/value pair by a prior event, the Baggage API -SHALL provide a function that takes a context and a name as input, and returns a +MUST provide a function that takes a context and a name as input, and returns a value. Returns the value associated with the given name, or null if the given name is not present. @@ -71,7 +71,7 @@ OPTIONAL parameters: ### Set baggage -To record the value for a name/value pair, the Baggage API SHALL provide a function which +To record the value for a name/value pair, the Baggage API MUST provide a function which takes a context, a name, and a value as input. Returns a new `Context` which contains a `Baggage` with the new value. @@ -90,7 +90,7 @@ for a string with no semantic meaning. Left opaque to allow for future functiona ### Remove baggage -To delete a name/value pair, the Baggage API SHALL provide a function which takes a context +To delete a name/value pair, the Baggage API MUST provide a function which takes a context and a name as input. Returns a new `Context` which no longer contains the selected name. REQUIRED parameters: @@ -103,7 +103,7 @@ OPTIONAL parameters: ### Clear -To avoid sending any name/value pairs to an untrusted process, the Baggage API SHALL provide +To avoid sending any name/value pairs to an untrusted process, the Baggage API MUST provide a function to remove all baggage entries from a context. Returns a new `Context` with no `Baggage`. diff --git a/specification/trace/semantic_conventions/messaging.md b/specification/trace/semantic_conventions/messaging.md index 872d7d93485..4523014ffda 100644 --- a/specification/trace/semantic_conventions/messaging.md +++ b/specification/trace/semantic_conventions/messaging.md @@ -75,7 +75,7 @@ Often such destinations are unnamed or have an auto-generated name. ## Conventions -Given these definitions, the remainder of this section describes the semantic conventions that shall be followed for Spans describing interactions with messaging systems. +Given these definitions, the remainder of this section describes the semantic conventions for Spans describing interactions with messaging systems. ### Span name