Skip to content

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

Open
wants to merge 20 commits into
base: develop
Choose a base branch
from

Conversation

pppelll
Copy link

@pppelll pppelll commented May 22, 2025

closes #1188

gist:ContingentObligation has changed to gist:ContingentCommitment following the deletion of gist: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.

…eed upon during 22 May 2025 gist development forum.
@pppelll pppelll self-assigned this May 22, 2025
@pppelll pppelll added the impact: major Non-backward compatible (changes inferences; e.g., adding a restriction, domain, range) label May 22, 2025
@pppelll pppelll linked an issue May 22, 2025 that may be closed by this pull request
3 tasks
@dylan-sa dylan-sa moved this to In Review in gist Version 14.0.0 May 22, 2025
Copy link
Contributor

@dylan-sa dylan-sa left a 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.

Copy link
Collaborator

@rjyounes rjyounes left a 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.

Copy link
Collaborator

@rjyounes rjyounes left a 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.

@rjyounes rjyounes self-requested a review May 27, 2025 18:27
Copy link
Collaborator

@rjyounes rjyounes left a 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.

pppelll and others added 7 commits May 27, 2025 15:23
…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>
@pppelll pppelll requested review from rjyounes and dylan-sa May 29, 2025 19:32
@pppelll
Copy link
Author

pppelll commented May 29, 2025

I have pushed a new version which takes into account suggestions from @dylan-sa , @rjyounes , and @uscholdm .

Copy link
Contributor

@uscholdm uscholdm left a 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.

Copy link
Contributor

@uscholdm uscholdm left a 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.

pppelll and others added 4 commits June 3, 2025 08:50
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>
Copy link
Contributor

@uscholdm uscholdm left a 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

pppelll and others added 3 commits June 4, 2025 11:08
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>
Copy link
Contributor

@uscholdm uscholdm left a 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.

@rjyounes rjyounes changed the title Address changes in issue 1188 Changes to Agreement, Commitment, and Obligation Jun 4, 2025
@rjyounes
Copy link
Collaborator

rjyounes commented Jun 4, 2025

@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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
impact: major Non-backward compatible (changes inferences; e.g., adding a restriction, domain, range)
Projects
Status: In Review
Development

Successfully merging this pull request may close these issues.

Changes to Agreement, Commitment, and Obligation
4 participants