review the use of RFC keywords should and must in the spec

sbgn / process-descriptions

SBGN PD specification

2 stars 4 forks source link

Open adrienrougny opened 1 month ago

adrienrougny commented 1 month ago

Target

Specification

Issue type

Bug

Bug report

Level and version Level:2 Version:0

Section and page Section:all Page:

Bug description Should is sometimes used in place of must.

Proposed solution Make sure that should (and must) are used adequately all along the specification.

hasanbalci commented 4 weeks ago

Candidates which may be considered to change:

[x] Section 2.3.1 - Container: should -> must
[x] Section 2.3.2 - Container: should -> must
[x] Section 2.3.5 - Container: should -> must (2 times)
[x] Section 2.4.5 - Container: should -> must (2 times)
[x] Section 2.4.6 - Auxiliary items - fourth paragraph: should -> must (2 times)
[ ] Section 2.5.1 - Auxiliary items - paragraph btw figure 2.20 and figure 2.21: should -> must
[x] Section 2.12.1 - Container: should -> must

In addition, there are suggestions regarding this issue in the pdf document in #228.