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

Adopt RFC2119 terms for requirements language #48

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

jmarinho
Copy link
Contributor

The IETF RFC2119 defines terms for requirements and guidance statements. This commit changes the spec to adopt those terms, where relevant, and requires future contributions to comply with RFC2119.

Fix #30

Change-Id: Ia4cc7f44bcd4508025f30d2410e83802c6ec4a11

containing platform-specific data or internal structures specific to a single
firmware implementation is no reason not to allocate a standardized tag for it
firmware implementation, should allocate a standardized tag for it
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That makes it significantly weaker. Is there a way to encourage this?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This reword was a nitpick.
It's simply removing the double negative.

We can drop the change.

I've reworded the sentence a bit in the latest push (hopefully respecting the original language):
"
In particular, a creator of a TE that just contains platform-specific data or internal structures specific to a single firmware implementation, should allocate a standardized tag for it in this specification -- using the non-standardized range is strongly discouraged.
"

The IETF RFC2119 defines terms for requirements and guidance statements.
This commit changes the spec to adopt those terms, where relevant, and
requires future contributions to comply with RFC2119.

Fix FirmwareHandoff#30

Change-Id: Ia4cc7f44bcd4508025f30d2410e83802c6ec4a11
Signed-off-by: Jose Marinho <jose.marinho@arm.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

use standard requirements language
2 participants