Staff Absences

Staff Send E-mail to "away@cscf.cs"

Staff who will not be coming in are requested to send email to away@cscf.cs to let management know that they will be away and provide a brief summary of the reason. This can include for illness, courses and other ProfessionalDevelopment, vacation, etc.

Updating the "away" File

Updates are usually done by the manager of the person who is away.

Find the File

Since many absences are due to vacations, there is a separate "away" file for each vacation year. The files reside near the page https://www.cs.uwaterloo.ca/cscf/internal/staff-absences/ which may be edited on any of the general.cs Unix systems. The "away" file for the vacation year starting in July of Y1 and ending in June of Y2 resides in

/software/wwwdata_cs.uwaterloo.ca/data/vhosts/cs/cscf/internal/staff-absences/data/

with a name of the form

Y1-Y2

E.g. for the 2010-2011 vacation year, that's

2010-2011

Update the File

Now that multiple people may be updating these files, we use RCS to avoid collisions. Files will be checked in quickly.

For each person, there is a stanza describing days away, and reason, as well as some other data.

The general form of absence dates is:

  Reason:
    Year:
      Month: Day,...,Day

where Day is of the form

  <number>[h[(a)|(p)]]

where h means a half-day absence, and the commented a or p refer to the morning (A.M.) or afternoon (P.M.). e.g.

  Vacation Dates:
    2009:
      Jul: 20h(p),21

means away the afternoon of the 20th, and all day the 21st.

There is a template in ./.ReadMe showing all possible headings, and provides some details about the fields. Comments may be appended to any line by enclosing the comments in parentheses "()".

The fields:

Total Used:
Total Left:
Total Days Sick:

may be left blank, as they can be computed from the absence dates. See ./.Readme for details. If they are non-empty, make sure that they are accurate.

Although not critical, indentation is currently done with a single tab per column, rather than spaces.

Update the WWW Page

Once the file has been updated, run `make` in the containing directory to update the data in ./vacation-staff, which is included by the WWW page ./index.shtml. E.g.

cd ..
make

Tell Staff of the Update

Let cscf-staff@cscf.cs know who's away.

Explicit Example for 2010-2011

On www.cs	On cscf.cs
ssh www.cs cd /software/wwwdata_cs.uwaterloo.ca/data/vhosts/cs/cscf/internal/staff-absences/data co -l 2010-2011 vi 2010-2011 ... ci -u 2010-2011 cd .. make	ssh cscf.cs cd /autofs/www/cs/cscf/internal/staff-absences/data co -l 2010-2011 vi 2010-2011 ... ci -u 2010-2011 cd .. make

Confidentiality

The illness history of staff isn't considered public, so the contents of the "away" files are private. Access is controlled by membership in group "mgmt".