-
Notifications
You must be signed in to change notification settings - Fork 21
Changes to Agreement, Commitment, and Obligation #1221
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
base: develop
Are you sure you want to change the base?
Changes to Agreement, Commitment, and Obligation #1221
Conversation
…eed upon during 22 May 2025 gist development forum.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added some tweaks to make.
docs/release_notes/issue1188-changes-to-agreement-commitment-and-obligation.md
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've suggested revisions to a number of your annotations. Regard these as hints about direction rather than hard-and-fast replacements. You may also want to add an example for each term; the Cambridge dictionary provides a lot of ideas for examples.
We prefer language which is clear and unambiguous but not overly technical; it should be easily understood by most ordinary readers.
docs/release_notes/issue1188-changes-to-agreement-commitment-and-obligation.md
Outdated
Show resolved
Hide resolved
docs/release_notes/issue1188-changes-to-agreement-commitment-and-obligation.md
Outdated
Show resolved
Hide resolved
docs/release_notes/issue1188-changes-to-agreement-commitment-and-obligation.md
Show resolved
Hide resolved
docs/release_notes/issue1188-changes-to-agreement-commitment-and-obligation.md
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I meant to request changes but submitted the review before doing so.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Still didn't work.
…nd-obligation.md Co-authored-by: Rebecca Younes <rebecca.younes@semanticarts.com>
…nd-obligation.md Co-authored-by: Rebecca Younes <rebecca.younes@semanticarts.com>
…nd-obligation.md Co-authored-by: Rebecca Younes <rebecca.younes@semanticarts.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is looking great - a few more suggested tweaks before I re-review the whole thing again from scratch.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A few more wording tweaks, mainly for brevity - regard them as optional, as you prefer.
docs/release_notes/issue1188-changes-to-agreement-commitment-and-obligation.md
Outdated
Show resolved
Hide resolved
Used Michael's suggested wording. Co-authored-by: Michael Uschold <uscholdm@users.noreply.github.com>
Reduced the scope of the example annotation to be just price (not frequency) and just access (not maintenance). Co-authored-by: Michael Uschold <uscholdm@users.noreply.github.com>
Co-authored-by: Michael Uschold <uscholdm@users.noreply.github.com>
Clarifying language according to Michael's suggestions Co-authored-by: Michael Uschold <uscholdm@users.noreply.github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is nearly ready, I see one or more unresolved comments/suggestions
Taking Michael's suggestions to clarify the language Co-authored-by: Michael Uschold <uscholdm@users.noreply.github.com>
…nd-obligation.md Small change to release notes Co-authored-by: Michael Uschold <uscholdm@users.noreply.github.com>
Co-authored-by: Michael Uschold <uscholdm@users.noreply.github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think this is good now. Lets see what Rebecca thinks.
@pppelll Just for future reference, please give PRs titles that explain something about what they are doing rather than referencing an issue number. The description is useful when scanning a list of PRs. Thanks. |
closes #1188
gist:ContingentObligation
has changed togist:ContingentCommitment
following the deletion ofgist:Obligation
. The definition of this class probably warrants extra attention with the new ways of modelling these concepts, and might require discussion during the next gist dev meeting.