Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Chapter 10 uses non RFC assertions #627

Closed
egekorkan opened this issue Nov 2, 2021 · 5 comments
Closed

Chapter 10 uses non RFC assertions #627

egekorkan opened this issue Nov 2, 2021 · 5 comments

Comments

@egekorkan
Copy link
Contributor

Chapter 10 talks about Abstract Servient Architecture. It is a non-normative chapter, yet it uses must, may, should in multiple places but not capitalized. This seems like a way to escape respec errors. A non-normative chapter is, as its negation implies, an informative chapter. If it is informative, why is the reader met with assertive words like must, may etc.? In W3C specifications (also IETF, OpenAPI, CloudEvents, etc.) these words do not mean much if not used capitalized, i.e. we can say must as much as we want but it does not constrain implementations in any way if we don't say MUST.

Thus, I propose to either remove these words and rephrase the sentences or make the chapter normative and change the words to their capitalized forms.

@egekorkan
Copy link
Contributor Author

Doing a case-sensitive search of the word must reveals this in many other places in the document, even normative chapters like 8.1.3.

@mlagally
Copy link
Contributor

@EGE: Can you please drive the discussion?

@egekorkan
Copy link
Contributor Author

What is the decision? Should we first make them assertions that can be easily tracked via the assertion script and then discuss whether they make sense?

@mlagally
Copy link
Contributor

@egekorkan
This section is informative, however I think some of these assertions would make sense somewhere else.
To be completely transparent it would be useful to tag them with the RFC2119 tags.

@mlagally
Copy link
Contributor

Arch call on June 23rd: We should leave this section alone for 1.1 and may be revisiting it in the 2.0 scope.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants