Skip to content

Explained the stakeholder term #3623

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.

Sign up for GitHub

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

Merged
olehermanse merged 1 commit into from
Apr 13, 2026
Merged

Explained the stakeholder term #3623

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions content/overview/glossary.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -292,6 +292,12 @@ Promises are idempotent, meaning they can be executed many times with the same o
They are also convergent, meaning they can only nudge the system closer to a steady state, never destabilize it.
While there are ways a user could override this, it's almost never a good idea to do so.

#### Promise stakeholder

The stakeholder is an optional part of a promise in CFEngine which gives you metadata about who the promise is made to.
It is commonly used with ticket IDs, CVE IDs, URLs, email addresses, or names of people / teams.
Stakeholders are sometimes referred to as promisees, but stakeholder is the preferred term.
Copy link
Copy Markdown
Member

@nickanderson nickanderson Apr 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

promisee is the "official" term afaik, but stakeholder makes more sense to most people.

Copy link
Copy Markdown
Member Author

@olehermanse olehermanse Apr 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not anymore :)

Copy link
Copy Markdown
Member

@nickanderson nickanderson Apr 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FOR EV ER


#### Promise types

Different types of resources you can manage with CFEngine.
Expand Down
8 changes: 4 additions & 4 deletions content/reference/language-concepts/promises.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,10 +46,10 @@ certain fact will be true. These facts are listed in the form of
attribute has a particular value (i.e. 775 permission value) and that an owner
attribute has another value (i.e. "root").

When a promise is made in CFEngine it is made to another entity - a
**promisee**. A promisee is an optional part of a promise declaration. The
promisee can help provide insight into the system's configuration, and may
become relevant as your system grows in complexity.
When a promise is made in CFEngine it is made to another entity - a **stakeholder**.
A stakeholder is an optional part of a promise declaration.
The stakeholder can help provide insight into the system's configuration, and may become relevant as your system grows in complexity.
Stakeholders are sometimes referred to as **promisees**.

The **classes** in a promise control the conditions that make the promise
valid. Examples are the operating system on which the policy is executed, or
Expand Down
Loading