Branching logic issue in Create Term Definition step 16

[kasei]

Create Term Definition step 16.1 uses passive language that doesn't seem to have any action expressed:

If value contains the @id entry is null, the term is not used for IRI expansion, but is retained to be able to detect future redefinitions of this term.

If no action is taken as a result of this step, step 16.4 will call IRI Expansion with a null value and raise an Invalid IRI mapping error. I don't believe this is the intention of step 16, and ask that it be clarified.

I believe the intended set of steps is something like this:

16. If value contains the entry @id and its value does not equal term:
    16.1. If value contains the @id entry is null, the term is not used for IRI expansion, but is retained to be able to detect future redefinitions of this term.
    16.2. Otherwise:
        16.2.1: [old 16.2, without "Otherwise" prefix] If the value associated with the @id entry is not a string, an invalid IRI mapping error has been detected and processing is aborted.
        16.2.2: [old 16.3]
        16.2.3: [old 16.4]
        16.2.4: [old 16.5]
        16.2.5: [old 16.6]

[gkellogg]

If the value is null, the remaining sub-steps in 16.1 should be skipped.

[iherman]

This issue was discussed in a meeting.

• RESOLVED: Add to 16.1 that the following substeps should be skipped if the test for null is true

View the transcript

Create Term Definition 16.1 needs more indents
Rob Sanderson: #241
Gregg Kellogg: we added some text in 16.1 to retain the information that @id has value null
Proposed resolution: Add to 16.1 that the following substeps should be skipped (Rob Sanderson)
Gregg Kellogg: in my code, the following substeps are skipped
Proposed resolution: Add to 16.1 that the following substeps should be skipped if the test for null is true (Rob Sanderson)
Gregg Kellogg: +1
Rob Sanderson: +1
Pierre-Antoine Champin: +1
Harold Solbrig: +1
Tim Cole: +1
Ivan Herman: +1
Benjamin Young: +1
David I. Lehn: +1
Resolution #6: Add to 16.1 that the following substeps should be skipped if the test for null is true

[gkellogg]

@kasei, please let us know if changes in #247 satisfactorily address your concern.

[kasei]

As mentioned in #247, I think the merged change isn't ideal as it is stylistically different from, and less explicit than semantically similar constructs used elsewhere in the API document.

[iherman]

This issue was discussed in a meeting.

• RESOLVED: Accept pchampin’s addition in PR 266 to further improve #241

View the transcript

16.1 needs more indents
Rob Sanderson: The last one needs discussion.
Rob Sanderson: #241
Gregg Kellogg: The change we made before was regarding a spec update in 16.1.
… We typically don’t do a change like this.
… We want to do the minimum change possible that addresses the issue, which is not necessarily how we would do it prior to CR.
Rob Sanderson: I’m happy eitherway. The further indentation is clearer and more consistent, but reducing the changes to what is necessary is probably a good operating mode.
Pierre-Antoine Champin: I also made a PR on this issue.
… I propose to not add an indentation, but change the step numbers.
… My proposal merges 16.1 into 16.
Pierre-Antoine Champin: #266
Gregg Kellogg: I need to look into it more carefully, but it looks like a better solution. It sticks with our normal style.
Rob Sanderson: This is the last issue before moving to BP.
Gregg Kellogg: Have we closed all issues that I marked as propose-closing?
Rob Sanderson: Do we want to accept pchampin’s change? Or do you want to read it first gkellogg?
Gregg Kellogg: We can go with pchampin’s change.
Proposed resolution: Accept pchampin’s addition in PR 266 to further improve #241 (Rob Sanderson)
Pierre-Antoine Champin: I anticipated that this PR might be rejected because it is sensitive. The first commit in the PR fixes an obvious typo, so it should definitely be retained, even if the PR is not merged.
Rob Sanderson: +1
Ivan Herman: +1
Gregg Kellogg: This PR is good anyways, but I may nitpick it a bit.
Ruben Taelman: +1
Tim Cole: +1
Pierre-Antoine Champin: +1
Gregg Kellogg: +1
Adam Soroka: +1
Resolution #8: Accept pchampin’s addition in PR 266 to further improve #241