-
Notifications
You must be signed in to change notification settings - Fork 8
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
Create sub-assertions for Keywords in the Links section #348
Comments
There are two parts to this: updating the markup, then updating the script to generate the implementation report based on this markup. Basically each row of each table needs a class assigned to it. Since these tables have different formats, I propose using a different class for each table: <tr class="rfc2119-link-type-assertion">...</tr> and <tr class="rfc2119-content-type-assertion">...</tr> For updating the script, I will also need a "template" for the assertion to include elements from the table. Let's discuss that in these comments; the template also needs to include the appropriate RFC2119 keyword. |
Another option here would be to have a standard format for "constraint tables" that potentially could be applied to other tables. If we use the format of the first table, with three columns, and can add an appropriate column to the content type table, then we could use a single class like "rfc2119-constraint-assertion". But I'm ok with using different labels for different table formats. |
Given the associated "parent" assertion for the Link table, "The following keywords are defined for links in the HTTP profiles and MAY be present in profile-compliant TDs with the constraints defined by this section," I propose the following template for each row of the link table. Actually, I realized there are MULTIPLE assertions needed since if it exists, the type and other constraints must be satisfied. So these assertions are MUST even though the parent is a MAY:
But even this is not right since even though the parent assertion says "MAY", most of the constraints have the word "mandatory" (which ideally would be in its own column, BTW), and the above sentence would not really make sense. So I'm not sure what is really needed here. If there is a separate column for "mandatory/optional" I can based the RFC2119 keyword on it. |
Link types and media type tables:
The text was updated successfully, but these errors were encountered: