OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

odata message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: RE: [odata] [OASIS Issue Tracker] (ODATA-1622) Avoid "MAY ... only if"


Ouch double negatives....

 

The provision should be on the provider.  Could we have an example that does not place a requirement on a client? 

 

G

 

 

 


Internal Use - Confidential

-----Original Message-----

From: odata@lists.oasis-open.org <odata@lists.oasis-open.org> On Behalf Of OASIS Issues Tracker

Sent: Monday, December 4, 2023 9:26 AM

To: odata@lists.oasis-open.org

Subject: [odata] [OASIS Issue Tracker] (ODATA-1622) Avoid "MAY ... only if"

 

 

[EXTERNAL EMAIL]

 

Heiko Theissen created ODATA-1622:

-------------------------------------

 

             Summary: Avoid "MAY ... only if"

                 Key: ODATA-1622

                 URL: https://urldefense.com/v3/__https://issues.oasis-open.org/browse/ODATA-1622__;!!LpKI!n_sINK3IMZD0C2AtBbsgzSoTFbEvpXr1lhikhs0CY8TlcxtNkbhB6Av88uOeJHLr18FVBrVlIA2u3ml22dr5oF-tiEee69R97PrsXA$ [issues[.]oasis-open[.]org]

             Project: OASIS Open Data Protocol (OData) TC

          Issue Type: Improvement

          Components: CSDL JSON , CSDL XML

            Reporter: Heiko Theissen

 

 

Combining the RFC2119 term "MAY" with a negation or restrictions runs counter to what MAY wants to express.

{quote}Clients MAY do A only if B

{quote}

sounds as if

* the client may choose not to do A if B (which is not always implied)

* there is no rule for the client if not B.

 

Instead, write

{quote}Clients MUST NOT do A if (not B)

{quote}

 

 

 

--

This message was sent by Atlassian Jira

(v8.3.3#803004)

 

---------------------------------------------------------------------

To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail.  Follow this link to all your TCs in OASIS at:

https://urldefense.com/v3/__https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php__;!!LpKI!n_sINK3IMZD0C2AtBbsgzSoTFbEvpXr1lhikhs0CY8TlcxtNkbhB6Av88uOeJHLr18FVBrVlIA2u3ml22dr5oF-tiEee69SNgDgf4A$ [oasis-open[.]org]

 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]