Commit 31b742d2 authored by Rieks Joosten's avatar Rieks Joosten

%%-syntax errors fixed

(cherry picked from commit 07e73d01b0fb16e924948d6d293a60afdd78e677)
parent d6540f5e
......@@ -16,4 +16,4 @@ A **dictionary-file** is a file that contains the specification of what does (no
%%Dictionaries|dictionary%% help people to figure out the meaning of terms, specifically if the context of the text they are interpreting isn't very clear, or the meaning of the used terms is left to the imagination of the reader.
### Criterion
a file that defines/specifies a %%dictionary|dictionary%.
a file that defines/specifies a %%dictionary|dictionary%%.
......@@ -16,4 +16,4 @@ A **glossary-file** is a file that contains the specification of what does (not)
%%Glossaries|glossary%% are %%dictionaries|dictionary%% that are limited to a specific purpose or %%scope|scope%%. They provide a single meaning for each term, enabling both authors and readers to quickly establish if they associate a term with the meaning as it is defined for that scope.
### Criterion
a file that defines/specifies a %%glossary|glossary%.
a file that defines/specifies a %%glossary|glossary%%.
......@@ -16,4 +16,4 @@ A **pattern-file** is a file that describes a %%pattern|pattern%%. To faciliate
Describing %%patterns|pattern%% enable users/readers to get a good idea of how related %%concepts|concept%% work together as a coherent and consistent whole. Mature patterns are generally simple, and make it much easier to think about the described concepts for someone that applies the pattern than it is for people that do not.
### Criterion
a file that defines/specifies a %%pattern|pattern%.
a file that defines/specifies a %%pattern|pattern%%.
......@@ -26,23 +26,23 @@ The main characteristic that people and organizations share, is everyone of them
#### Coherence between %%parties|party%% and Actors
One may also readily observe that in other ways, people and organizations differ. For example, people eat and drink, whereas organizations do not. People can sit behind a computer keyboard, type texts, hit the `Enter` button, e.g. to send an email. Organizations cannot do that. In short: people can act (do things), whereas organizations cannot. The characteristic that sets people and organizations apart is the ability to act.
One may also readily observe that in other ways, people and organizations differ. For example, people eat and drink, whereas organizations do not. People can sit behind a computer keyboard, type texts, hit the 'Enter' button, e.g. to send an email. Organizations cannot do that. In short: people can act (do things), whereas organizations cannot. The characteristic that sets people and organizations apart is the ability to act.
We will use the term %%actor|actor%% to refer to %%entities|entity%% that are capable of acting (doing things); people will qualify, whereas organizations do not.
Notwithstanding that organizations cannot act, it is quite common to hear statements that seem to imply that they can. If ACME is an organization and someone says: "I just received mail from ACME", this cannot be literally true as organizations cannot send messages. It is either a person or a computer system that has actually sent it. Statements such as these must therefor be interpreted in a figurative way, as a 'shorthand' for 'I just received mail that was sent by some %%actor|actor%% that `was acting on behalf of` ACME'.
Notwithstanding that organizations cannot act, it is quite common to hear statements that seem to imply that they can. If ACME is an organization and someone says: "I just received mail from ACME", this cannot be literally true as organizations cannot send messages. It is either a person or a computer system that has actually sent it. Statements such as these must therefor be interpreted in a figurative way, as a 'shorthand' for 'I just received mail that was sent by some %%actor|actor%% that was `acting on behalf of` ACME'.
When an %%actor|actor%% is `acting on behalf of` some %%party|party%%, it is executing a single %%action|action%%. This constraint is necessary as we must allow actors to multi-taks, i.e. execute different actions more or less simultaneously, where it might execute each such action on behalf of a different %%party|party%%.
In this relation `is acting on behalf of`, actor plays the role of %%agent|agent%% (of that %%party|party%%), and the %%party|party%% performs the role of %%principal|principal%% (of that actor).
In this relation is `acting on behalf of`, actor plays the role of %%agent|agent%% (of that %%party|party%%), and the %%party|party%% performs the role of %%principal|principal%% (of that actor).
Thus, being an agent implies that an action is being executed on behalf of some %%party|party%%. However, we also like to talk about actors for which it is realistic that they might do something for some %%party|party%%. It seems obvious that an actor, for which the %%party|party%% has the %%legal or rightful title to control|owner%% it, would qualify as such. But a %%party|party%% may also get actors that it doesn't %%own|owner%% to `work for` it. may have various meanings:
1. ACME may be the %%owner|owner% of that actor. This would be the case e.g.if the mail was sent by one of ACME's running business applications.
2. ACME may employ, or otherwise hire that actor. This would be the case e.g. if one of its %%employees|employee%% sent the mail, or a business application that is owned by another %%party|party%% sent the mail on behalf of ACME. How this works is the subject of the pattern %%Mandates, Delegation and Hiring|pattern-mandates-delegation-hiring%%.
1. ACME may be the %%owner|owner%% of that actor. For example, this would be the case if the mail was sent by one of ACME's running business applications.
2. ACME may employ, or otherwise hire that actor. For example, this would be the case if one of its %%employees|employee%% sent the mail, or a business application that is owned by another %%party|party%% sent the mail on behalf of ACME. How this works is the subject of the pattern %%Mandates, Delegation and Hiring|pattern-mandates-delegation-hiring%%.
Note that owning, employing (or hiring) an actor is a condition that usually exists for a considerable time, at least in the order of days (weeks, months). However, some actors (e.g. humans) are capable of multi-tasking, i.e. they can do several actions (pretty much) simultaneously. For example, a person that is working for some organization may make a personal phone call, or send a personal email during working hours. This shows that the 'working for` (some %%party|party%%) condition can mean two things: either it is the status/condition
- that allows/enables the actor to act on behalf of some %%party|party%%. We refer to that as `working for`, e.g. `actor A works for %%party|party%% P`. In this relation `works for`, the %%party|party%% performs the role of %%employer|employer%% (of that actor), and the actor plays the role of %%employee|employee%% of that %%party|party%%.
Note that owning, employing (or hiring) an actor is a condition that usually exists for a considerable time, at least in the order of days (weeks, months). However, some actors (e.g. humans) are capable of multi-tasking, i.e. they can do several actions (pretty much) simultaneously. For example, a person that is working for some organization may make a personal phone call, or send a personal email during working hours. This shows that the `working for` (some %%party|party%%) condition can mean two things: either it is the status/condition
- that allows/enables the actor to act on behalf of some %%party|party%%. We refer to that as `working for`, e.g. "actor A works for %%party|party%% P". In this relation `works for`, the %%party|party%% performs the role of %%employer|employer%% (of that actor), and the actor plays the role of %%employee|employee%% of that %%party|party%%.
- the status/condition that an actor is executing a specific %%action|action%% on behalf of that %%party|party%% at some given point in time. We refer to that condition as `is acting on behalf of` or `is executing an action on behalf of`. We expect that whenever an actor is acting on behalf of some %%party|party%%, it must also work for that %%party|party%%.
%%Actions|action%% can usually be executed in different ways. For example, sending a mail on behalf of some organization may require that the mail template and logo of that organization be used. Or accepting an order usually requires a check to see the order is 'clean', i.e. can be processed by others in the organization. What a 'clean-order check' comprises is to be determined by the organization.
......
......@@ -16,7 +16,7 @@ A **scope-file** is a file that contains the specification of a specific %%scope
%%Scopes|scope%% enable people to focus, which is important as people's short-term memory is limited to 7 +/- 2 concepts (with attributes) [(Miller, 1956)](http://psychclassics.yorku.ca/Miller/). Hence, defining a scope - what is in it and what is not - is relevant as well.
### Criterion
a file that defines/specifies a %%scope|scope%.
a file that defines/specifies a %%scope|scope%%.
### References
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment