From 1b6afc2e05347df01c8402db96442a881e19f550 Mon Sep 17 00:00:00 2001 From: "Karl O. Pinc kop@karlpinc.com" Date: Mon, 1 Jun 2026 19:18:25 +0000 Subject: [PATCH] Update roles docs to note that roles apply to feeding station attendance --- doc/src/tables/roles.m4 | 21 +++++++++++++++------ 1 file changed, 15 insertions(+), 6 deletions(-) diff --git a/doc/src/tables/roles.m4 b/doc/src/tables/roles.m4 index dc92d50..eb19a64 100644 --- a/doc/src/tables/roles.m4 +++ b/doc/src/tables/roles.m4 @@ -25,8 +25,9 @@ ROLES ----- .. |ROLES_summary| replace:: - Each row represents a participant in an event that occurred during - a follow, whether involving the focal or not. + Each row represents a participant in an event that occurred. + Events occur during a follow, whether involving the focal or not, + and during attendance taking at the feeding station. |ROLES_summary| Events may have zero or more participants involved; rows on |EVENTS| @@ -35,12 +36,20 @@ Usually, there will be at least one participant. But this is not true of events that are no more than a record of the presence of other species sighted during a follow. -The participant in the event must be under study on the date of the -follow. -This means that the |FOLLOWS|.\ |FOLLOWS.Date| related to the event -must be between the |ROLES.Participant|'s |BIOGRAPHY_DATA|.\ +The participant in the event is required to be under study +on the date of the follow, for follow related events. +This means that, when the event occurs during a follow, the +|FOLLOWS|.\ |FOLLOWS.Date| related to the event must be between the +|ROLES.Participant|'s |BIOGRAPHY_DATA|.\ |BIOGRAPHY_DATA.EntryDate| +and their |BIOGRAPHY_DATA|.\ |BIOGRAPHY_DATA.DepartDate|, inclusive of +endpoints. +If this is not the case the system will immediately raise an error. +When the event occurs during attendance taking at the feeding station, +the |ATTENDANCE|.\ |ATTENDANCE.Date| related to the event should be +between the |ROLES.Participant|'s |BIOGRAPHY_DATA|.\ |BIOGRAPHY_DATA.EntryDate| and their |BIOGRAPHY_DATA|.\ |BIOGRAPHY_DATA.DepartDate|, inclusive of endpoints. +If this is not the case the system will generate a warning. The system will generate a warning if a participant is not present in the follow at the time of the given event. -- 2.34.1