Here's an idea for organizing this section -- have subsections for each 2.X-
level section, as well as others that may have gone away and don't fit in the
current 2.X structuring. As far as the text goes, maybe we can leave it pretty
raw and informal, treating it like a (b)log of thoughts along the way. I think
this might work, and lead to getting the fucker done before death.
6.1. For Next Check-In
When user X opens a cal file copied from user Y, including one created by an admin in a distribution, user X becomes the user of record for that calendar at the point of opening, i.e., the opening user's ID is made part of the opened calendar and will be saved as such when and if the user does a subsequent File->Save.
A big pilo crap follows, spewed originally in ``.sh 4 "Local Files"''. It's indented to distinguish this particularly largish crap pile for the rest. (Indenting crap piles seems to be an evolving convention). Each paragraph is also annotated with where it's been dealt with.
Say that the implementors can figure out how/where exactly to define this (the location of the user dir), including one or more of these ways: ... . The effect must be that when the cal tool is subsequently invoked, it looks for the Settings file and non-path-prefixed calendar files in the specified directory. This is pretty fucked up, but it's been dealt with in the development overview subsection on implementation considerations.
Hmm hmm, I think having one-by-one naming for each file is probably (way) overkill, cfing Emacs single .emacs file; also, wait a mother-fucking minute -- we may have a huge motherfucking chicken and egg problem with the whole local files thing altogether, since where the fuck does this setting get saved; i.e., it would seem there needs to be at least one known place to look for things, unless we want to modify the app itself, which sounds fucked up; what I think we're getting at is the the local files determination needs to be made at installation/configuration time, not dynamically. Dealt with by having only one Settings file read at start up; chicken and egg problem dealt with in developer_overview.implementation_considerations.
Hmm, maybe we want to let the user specify one-by-one where each of the different files goes, rather than having the idea of a specific known directory. This is probably the more flexible way to do it, if it works OK. One fucking way or another, we need to fully figure out what known places the Calendar Tool needs to be aware of and what the full ramifications of knowing these places are. Dealt with by having one Settings file and, again, in implementation considerations subsection.
Local Files dialog now has two items: path for local file directory and name of default calendar file to open when the app is launched as an app as opposed to from a file. If the user specifies a value for the default start-up calendar and then invokes the cal tool from a file, the file from which the tool is invoked overrides the default start-up calendar. Dealt with in "Files Used by the Calendar Tool" subsection and future work item about command-line arg to specify start-up settings file. The idea of a single default calendar to open has been extended to the "open calendars" part of the session-wide settings.
24jun04 NOTE: Since we've nixed the "CommunityCalendar" idea, what we can say about calendar files and the local files directory is that the directory so specified is the default place where calendars will go. Given the current set up of things, all this really means is that that dir is the default path when calendar file chooser is initially opened. Related to this, we need to figure out if the file-chooser dialogs have temporal memory, as in they come up in the place that they were most recently OK'd (but not Canceled) on. I think the answer to this is almost certainly yes. Dealt with, as aluded to, in the "new setup" of things. Temporal memory in dialogs dealt with in specific subsection in data entry details.
NOT to all of the following paragraph; coverage of `File->Local Files' since it's been nuked as a command and moved to Admin options; the priv admin `File->Host Files' has been moved to the priv Admin menu. So, what this section covers is what's in the files (a review, most likely), but not these two commands, since they're not on a file menu anymore. Dealt with as the paragraph itself explains.
Need to cover `File->Local Files' command here or elsewhere, as well as the privileged admin `File->Host Files' command. With `File->Local Files' regular users should be able to set the path to where the local files are. When creating a config, admins can set the default value for the local files. Dealt with fine in the new scheme of things; in particular, admins don't do configs per se anymore, but can set location of user dir by creating a settings file using the regular calendar tool.
There are four standard fixed-name files used by the CalendarTool:
Dealt with by consoldating everything into cal-specific and session-wide settings, in cal files and settings file, resp.
- "CommunityCalendar": [THIS IS WRONG NOW, need to decide if we want to keep CommunityCal around anyway as the "standard", or more likely "standard sample" normal calendar] the place where the central host expects to find the calendar that the user shares with the Calendar Tool community
- "Options": the standard options file that is used to set the initial options for all new calendars
- "Configuration": the file where the results of the `Save Config' command go, that says what windows are up initially and where they are
- "Intialization": the command file read in by the CalendarTool whenever it starts up
- "FileInfo": file containing settings established with the `File->Connect' and `File->Local Files' commands.
Given the nixing of CommunityCalendar as the global calendar, the following paragraph is WRONG. If the CommunityCalendar file is deleted or corrupted, it's as if the user sets `Options.Meetings.When to Show Meeting Notifications' to `never', but otherwise things are as normal. Note that deleting (or renaming) CommunityCalendar on the user's local computer does not delete any of the user's community calendar information on any central host on which the user is registered. In order to do this, the user must contact the system administrator(s) on the host(s) from the user wants to be unsubscribed. There need not be any explicitly identifiable CommunityCalendar file on the central host. It is up to the user to be prudent about saving backup copies of calendar files, including the CommunityCalendar. There is no Calendar Tool command to download the contents of a CommunityCalendar file from a Calendar Tool central host. Dealt with as the paragraph itself explains; also, the matter of deleted or corrupeted files in general is dealt with in File subsection on this topic, as well as Error Conditions section as appropriate.
The next NOTE was correct -- all pretty much obsolete bullshit. Went through it and found a couple thigs that helped firm things up in the final version of the File section, so put a motherfucking fork in it.
NOTE: I'm pretty sure that all of the subsubsections that follow are bullshit, but may have some useful info. Check them out one last time to be sure.
.sh 4 "Save As and Load in Editing Dialogs"
9jul94 ADDITIONAL NOTE: OK, I'm just about ready to fuck the SaveAs/Load shit in all of dialogs where they appear. This will nicely simplify things, and users who give a fuck can --- OK, fuck me, we're going around in circles again. If we lose the SaveAs/Load shit in the dialogs, then there's no particularly convenient way to get, say the options, unbundled from a calendar file. One way might be to provide a "Clear all items" command, say in edit, that could be used to get rid of everything but the aux data, and then a new calendar could get another calendar's aux settings by copying the first calendar into the new one and then nuking all the items in the new one. This really anin't too bad, given the complication it avoids and the fact that we can still get done what we'd like to get done. To whit:
- ...
OK, fuck me hard, one more time, way up the motherfucking ass. Let's just stick with what the fuck we have, including the fucking-ass complicated new row of buttons in the connections table, explain it clearly and get the fuck on with it.
No, but now fuck me again. Probably the bottommost line here is how useful the aux data file saveas/load bullshit is, and I think the answer is honestly not very fucking much useful. For me, I'm likely to have a few calendars at most, and not be spending my motherfucking life building caltool aux data files. So, I think except probably for Options, which are a big pile of do-do, we'll nix SaveAs/Load. If I like the categories, lists, or filters so fucking much in one calendar file, then I can copy the file, do a "clear all items" and get the fuck on with it.
Or one more motherfucking possibility is to have a 'Save Settings' command in the file menu that can be used to save all of the non-scheduled-item data in one motherfucking Settings file (maybe even including options). We'll also need a File->LoadSettings to go along with this. This way I can save all of the motherfucking settings in one place and load them up if I give a fuck about them for some other calendar. In this scheme, we can fuck the explicit Options file, having a configured distribution of the tool with the options settings in the tool itself, and provide a `Restore Defaults' button in the options dialog, instead of SaveAs and Load. ALSO (IMPORTANT) -- nuke File->SaveConfig in favor of a new Options.Viewing.Misc setting that allows `From last time' (or something like it) for the `Initial View' option (in Figure 283).
9jul04 NOTE: (1) Itemize the dialogs in which these commands appear; (2) explain why only the host-connection dialog has `Save' in addition to `Save As', whereas all the others have only `Save As', the explanation being that the host-connection dialog is the only one that is editing non-calendar-specific data that is stored someplace other than the current calendar).
NOTE: Adjust the following fodder pulled from the options section to apply uniformly to all four types of aux data (which will have been clearly defined in the intro of this section). What might be nice is to use this options-specific scenario as the concrete example for all five types of aux data. See also the semi-epiphany in Section .
The `Save As ...' button is used to save a copy of the current option settings in a selected file. Saving options in different files allows the user to create different option configurations that can be loaded using the options `Load' command. When the user presses `Save As ...', the system displays a dialog of the form shown in Figure 309.
Figure 309: Options save-as dialog.
The default save-as directory is the user's Calendar Tool directory, the default name of which is ".CalendarTool". The four listed files are the standard files created when the Calendar Tool is installed, as described in Section . Section . covers complete details of the format and use of file saving dialogs, including the directory browsing list and the warning issued when an extant file would be overwritten by the save.To save options to a file, the user enters the filename in the save-as dialog and presses `OK'. For example, Figure 310 shows the user having entered the file name "PersonalOptions" as the location to which options are saved.
Figure 310: Saving options to a PersonalOptions file.
The `Save As' command does not execute `Apply' or `Save', it only saves a coy of the current options settings on the selected file. The applied and saved states of options are unchanged after execution of `Save As'.The `Load ...' button is used to load a previously-saved options file. When the user presses `Load ...', and there are no unapplied or unsaved options, the system displays the dialog in Figure 311.
Figure 311: Options load dialog.
The names of valid options files appear in normal typeface in the directory list; all other types of files appear in greyed typeface. Section 2.8.2 covers further details on the format and use of file opening (i.e., loading) dialogs, including the directory browsing list and file-type validation.To load options from a local file, the user selects or enters a filename in the `File:' text field. The user can alternatively load the administrator-defined options file from the Calendar Tool central host computer, if the user is currently connected to an operational central host (see Section ). If the user is not so connected, the `Load from central host' checkbox is disabled. Figure 312 shows the user having selected to load from the "Personal Options" file.
Figure 312: Loading from the Personal Options file.
Figure 313 shows the case where the user selects to load from the central host.
Figure 313: Loading options from the Calendar Tool central host.
When the central host checkbox is selected, the File and Directory data fields are cleared and disabled. The user confirms the load by pressing `OK', whereupon the option settings defined in the loaded file become the current unapplied and unsaved settings in the options dialog. (To restore the Calendar Tool to the global default options configuration, the user can save the options settings loaded from the central host to the local Options file.)If there are unapplied or unsaved option changes when the user presses `Load ...', the system issues the warning shown in Figure 314,
Figure 314: .
where affected is one of "unapplied" or "unsaved", as appropriate. Unapplied changes are also unsaved, given that saving automatically applies. The user presses `Yes' to proceed, `No' to cancel the `Load' command.The `Load' command does not perform `Apply' or `Save'. Once options are loaded, they are both unapplied and unsaved. Hence, loading has precisely the same effect as if the user had manually entered all of the loaded values in the options dialog.
Leaning towards fixing the following paragraph to allow load from (and maybe save to) two sources -- options files and (portions of) calendar files. If this happens, we need to fix above too. See Section for an overview. So if we allow load from cal file but not save-as to cal file, here's how we accomplish save-into: open the cal file, load, save (as opposed to save-as).
Even though calendar-specific options are stored within calendar files, the `Save As' and `Load' option commands operate only on separate options files, not on the options portion of calendar files. The system considers calendar files and saved option files as two different file types (see Section ). When an extant calendar file is selected in the `Save As' file-selection dialog, saving to that file replaces the previous file contents entirely, in just the same way as saving to any other extant file would do. The `Load' options command can only be used to load previously saved options files, not the options portion of a calendar file. Sections Section 2.8.2 and describe how file dialogs display inapplicable file types and the details of overwriting extant files.
Since options are calendar-specific, the `Apply' and `Save' commands operate only on one calendar at a time, namely the current calendar. Switching to a different current calendar always makes the options for the newly current calendar become active, without applying or saving options for the previously current calendar. Given this behavior, there is no direct way to save or apply the same option settings to multiple calendars en masse. To apply or save the same option settings to more than one calendar, the user must save the options to a file, make a new calendar current, load the saved options, and then apply or save the loaded options to the newly current calendar.
Any applied but unsaved changes are not saved by `Cancel'. If the options dialog is subsequently opened on a calendar with unsaved option settings, the unsaved state of the options is reflected by the `Save' button being enabled. If user closes a calendar with unsaved options or exits the Calendar Tool when one or more calendars have unsaved options, the system warns the user of the condition, as described in Sections 2.3.6.1 and 2.8.7.
2jul04 NOTE: Be sure to cover the (possibly subtle) distinction between option saving from within the cal tool admin program versus the regular-user cal tool. Viz.,
- When an admin does regular File->Save, user-related option values always go in the Options file, since there is no calendar in/with which to store options calendar-specifically; I suppose we could say that options are "distribution-specific", but it seems this would not work well at all, since there's no distributional analog of the "current calendar".
- Otherwise, the file-related option dialog buttons should behave the same for the admin as for the regular user. The usage semantics may differ a bit, and be worthy of explaining, as in the reason the admin does an options-dialog `Save As is to create (conveniently) a reusable options "bundle", that may be useful generically for different custom distributions. As with the regular-user version of the options dialog, `Save As' is no big deal, since it can be accomplished pretty easily at the OS level via file copy. However, it's worth having, and for fuck's sake, even if it isn't, it's not at this point going to get nuked from the multitude of option screen shots we have.
And here's a blast form the not-so-distant past about the now-gone `File->Local Files' command.
.sh 4 "File Connect and Local Files"The `Connect' command was described in Section 2.6.6.1 on administrative commands. When the user selects the `Local Files' command, the system displays the dialog shown in Figure 315.
Stick in the `Default Calendar Tool Directory'
Also add field for entering default calendar to open on fileless app launch.
item from the Admin tab of the Options dialog.Figure 315: Local files dialog.
The following has been dealt with fully, including nixing the idea of being able to overwrite non-calendar files:
.sh 4 "File Types"Discuss the different file types and the ramifications thereof, including that file types are used to do the filename greying thing in open/load dialogs, and that file typing may vary in different operating environments.
OK, try this: (See the semi-epiphany in options.me.) Also, as a non-annoying emacs-like behavior, we'll list all file names greyed out in all save-as dialogs, but all the user to select them. This way in contexts like the options save-as dialog, we can let the user select the standard Options file in the chooser for overwriting. Given this behavior, we may well want to specialize the overwrite message into two categories: (1) overwriting an extant file of the correct type (e.g., overwriting Options from the options save-as dialog or an extant cal file from File->Save As) (2) overwriting an extant file of the wrong type (e.g., overwriting Categories the options save-as dialog or an extant file of some non-cal-tool type from the File->Save As dialog. It think is is all pretty farging sweet.
Done and expanded upon:
.sh 4 "Calendar File Contents"
- scheduled items -- initially empty
- categories -- initially holidays
- custom lists -- initially empty
- filter settings and custom filters -- all shown, custom filters empty
- windowing mode -- initially per-level
- options -- initially obtained from default options file (Options by default) (hmm, there's potentially a chicken-and-egg problem lurking here; figure it the f out)
- windows
Here's a slew of seriously funked up bullshit about saving and loading settings (hold on a minute, we're still seeing if it's really seriously funked up): ... OK, I've held on and checked things out. Some of it isn't so funked up after all, but things have been fixed in the latest version of the file section, and here's the stuff to which I refer:
12jul04 -- OK, we need to add to the `Load Settings' dialog the option to load them from the current host, which replaces the short-lived but seemingly uninspired `Options->Load from Host' command.It's more than just the window configuration since it includes what files are open. I think the easiest way to define exactly what save configuration does is as a script file. This way we can deal with the tricky issue of having the display look the same, but having the displayed content all be relative to today's date. If for some reason the user would like to have a configuration that is absolute datewise, or relative some other date than today, then she can tweak the generated script from `Save Config', or of course write her own start-up script from scratch. An issue we need to deal with is the relationship between the option setting of what we call "the standard default view" in the ui-overview. Here's what I think could work well: There is an option called `Start-Up View Level' that specifies the default viewing level from item to year. If there is no init file in the user's home dir (per OS-specific definition of "home dir" and as discussed further in Admin section), then the Cal Tool comes up a la described in the initial screen config in the ui-overview. Viz., there's a menubar and zero or one view window at the level specified by the setting of `Start-Up View Level', open on today's date. If there is an init file or the tool is invoked with an start-up file in the command line or from a start-up file icon, then we could do one of two things:
- The system displays no windows automatically, thus ignoring entirely the setting of default-init-view-level; this means that the mere existence of an init file means there's no default display, and I don't think I like this; so let's try thing b ...
- The system proceeds to put up the initial window per default-init-view-level, and then goes about executing the init file. If the user really wants to get rid of the default initial window(s), she puts this code at the beginning of the init file, which code closes the initial window:
This works because of the rule that says the default window is put up before the init file is run, which means therefore that it's window 1 in the windows list, hence the arg of 1 to ViewWindows (assuming lists start from 1 like humans think, not from 0 like geeks think). But given this, here's an even simpler bit of code to do the same thing:ViewWindows(1); FileClose();which works for hopefully obvious reasons.FileCloseAll();This all seems pretty darn clean. To be consistent, it seems with this scheme that the first line of the init file saved with `Save Config' will in fact be the preceding chunk of code to close the default window, so that the config file starts with a blank slate.
Another 4aug03 NOTE. OK, I think I want to take back what I say in the next paragraph. I think it's appropriate to require that each user calendar be stored in a separate file in a known (settable) dir, with some reasonable convention for file name, such as the user's ID plus ".cal" extension.
4aug03 NOTE (if not mentioned elsewhere): Implementors can choose how they implement the central host repository, e.g., having a separate cal file for each user or having all user cals in the same file, or some other implementation. There is no requirement that a user be able to view the contents of a calendar in the central repository as a raw file in any form. Operationally, the user has her own local calendar as a file with a known name. On the remote host, the publicly-visible contents of that calendar are made available to other users through the calendar tool, via the operational effects of connecting and file saving described herein. Again, however, there is no requirement for the user to see a specific calendar file on the central host.
Nixed the auto update of host tab in the next bit, but did address the issue of warning on save-as when current cal is connected:
`Save As' needs to issue a warning when the current calendar is associated with a connected host. The warning should allow the user to stay connected, with the host connection table automatically updated.
Decided against the following, since user can move/remove Settings file if she doesn't want it used on File->New, or load a cleared version of settings at any time:
The `Load Settings' dialog also has a radio buttons for `load settings on File->New' versus `Use installed default settings on File->New.
I was thinking about a adding an admin option for `Auto-save tool-wide settings on exit' but decided it wasn't necessary because (a) there are only two such settings (open cals and connect tab), (b) open cals ain't that important, (c) there's already a convenience Save button in connect tab dialog. Also, I don't think it's necessary to warn the user on exit if the only unsaved tool-wide setting is current open cals, since that's not really a big deal given all the other ways that the user can save this stuff, and it's certainly not critical to operation if it's missed when the user wanted it not to be. The emacs hack would say to add the yes/no option warn-on-exit-if-open- calendar-names-setting-not-saved.
Most likely nix the following bulleted list.
File-related commands allow the user to perform these functions:
Print crap:
The printing functionality in the initial version of the Calendar Tool is limited ... . Make it just screen shots.OLD: Sketch of some ideas: The print dialog should include at least the following options:
But woe nelly, I just had a look at all of the features in Claris, particularly for the "book" option, including editing its format. I think this will be an excellent place to draw the line and say that fancy printing will be part of future work.
- start date
- end date
- apply active filter?
NOT SIMPLE ENOUGH: So, here's the deal with printing. We'll keep it brutally simple by printing out in the plain text form of the current example- items file. In fact, we can use this file pretty much as is, except for the parenthetical remarks about edits made. We'll also need to add some kind of indication of individual instance changes to recurring items, which will be done in the same brutally simple form.
Exit crap:
At this point, it looks like, oh please say it's so, that Exit can do exactly what Close All does in terms of offering to save. Hope the fuck so. Well, at least one additional thing Exit needs to check is if there have been changes to either of the session-wide settings since settings were last saved (including the save in the global options and connection table dialogs), i.e., open calendars and connection table.
If the user exits or closes a calendar with unsaved options, then in addition to whatever offer-to-save file messages there may be, there are also offer-to- save options messages. Viz., there is one such message for each active calendar for which options have been applied but not saved. The text of these offer-to-save messages should most likely be integrated into the file offer-to- save dialogs, so two dialogs don't appear if both the file data and options need to be saved for a particular calendar.
If the user exits or closes a calendar with notifications that have not yet been responded to, the system displays a dialog of the form:
If the user chooses 'Review' and then grows tired of it before all notifications are processed (where processing means pressing one of the three buttons on the bottom, or explicitly closing the notification dialog (which is equivalent to Delay)), then she can select Exit of Close again (whichever of which started the whole thing, or either) and then hit Discard. (Or use ... (fell the fuck off, but who gives a fuck at this point.))There are meeting notifications you have not yet processed. Do you want to review or discard the unprocessed notifications? Review Discard
The change in location of the repository directory does not affect any of the contents of the repository files or subdirectories. All of these files and subdirectories are moved in tact from their previous location to the new location.
When the administrator applies a change to the repository location by pressing `OK' (should be apply), the system verifies that the specified file path is valid and readable and writable by the Calendar Tool Administration program. If it is not, the system reports an error as described in Section . To avoid operational disruption, the `Host Files' command is disabled when the server is running.
NOTE 12jul04 -- OK, this section [admin options] is pretty well messed up. The deal is that the long-held idea that the admin would define user options by using a mock version of the user prefs is outta here. Instead, we'll have admin-relevant options tabs for `Times and Dates' (which turn out in fact to be relevant in an number of admin dialogs), `Fonts' (which are pretty much always relevant options in any app that does not want to be a pain in the neck by not letting users change display fonts), and `Administrative' (which presumably will stay the same as the current `Administrator' subtab, with whatever recent mods are necessary, at least one mod being the likely addition of the a place to set the host dir, to parallel the new way things are in the regular user UI, where `File->Local Files' is now gone). And the way the admin will define user options is to invoke the regular Calendar Tool, and do the normal options and save-settings things there. Even though this may not be quite as convenient as the old way (and this is debatable), it's way fucking less convoluted than having what was turning into a major pain in the neck of having two ways for the admin to set user options. One of the key discoveries that tore it was trying to figure out where the fuck the options-containing settings file would go when the admin did a `File->Save' in the admin program. We probably could've figured something out, but it was definitely getting fucked up to have the two ways of admins setting user options. So, get to it and fix this.
For an administrative user running the Calendar Tool Administration program,
the `Options' command menu and top-level tabs of the options dialog
are the same as for the regular Calendar Tool user. Physically, the only
difference between the administrative version of the options versus the
regular-user version is that the `Administrative' tab has two subtabs,
as shown in Figure 316.
Figure 316: Administrator version of the Administrative options Tab.
Functionally, the administrator version of the options dialog differs fundamentally from the regular-user version. In the administrator version, none of the option settings, except those shown in Figure Figure 316 applies to the Calendar Tool Administration Program itself. Rather, when an administrator makes changes to options values, the changes are recorded for use in creating customized Calendar Tool distributions, as described in Section . The point is, none of the option settings for regular-user commands apply to the Calendar Tool Administration program, since the administration program does not perform calendar scheduling or viewing. Hence, except for the one administrator-specific subtab, administrator-supplied option settings apply to custom distributions of the Calendar Tool, not to the administration program itself. In a given custom distribution, these options serve as the installed default settings until changed by the regular user.
In keeping with the functionality just described, the `Apply' button in the administrator version of the options dialog is only enabled when the administrator has made a change within the `Administrator' subtab. Otherwise, the option dialog buttons in the administrator version function the same as in the regular-user version of the options dialog, as described in the preceding scenarios.
The `Administrator' subtab in Figure 316 applies specifically and exclusively to the Calendar Tool Administration program.
Re. `Initial View' level, to be consistent with the way things are explained in specific-date-viewing, the default level cannot be at the item level. Nor do I think it makes particularly good sense to have it be some list. Therefore, the default initial view level is one of four day through year levels, and perhaps a "no window" option.
Here's a potentially interesting bit of going around in circles regarding whether to have options to allow the user to change ID and password:
Add options for default caltool user ID and password. These are the ones tried first for connect. NOT -- IDs and passwds are now in connect dialog. NOT NOT -- they're not in the connect dialog, so we do want options here for default ID and passwd. NOT NOT NOT -- the user doesn't get to change his ID himself, and the password is chaged using Admin->Change Password, q.v.
And for an example of a brain-damaged option (at least now given that the only way to contact an admin is via the Admin menu):
The option to 'Hide Admin menu when not connected' controls when the `Admin' menu appears ... ..sh 5 "Platform-Dependent Options"
As of 23jul02, I'm saying a firm (as possible with me) NO to this.
Although we'd like to avoid it, it may be necessary to at least plan for platform-dependent options that may be needed for networking connections. If at all possible, I'd like to avoid these. They sound like a cop out to me.
Well farg me, the hoped-for ``Final Sketch'' in the next paragraph wont fucking work -- take a mf look at options-admin-admin.idr. So, do this:
Final Sketch:
Table 19: Default values for all admin-
dialog data fields.
NOTE: There needs to be a place for privileged admin-specific options, in particular these:
The options dialog that runs under Calendar Tool Administration has the same overall format as for regular users, except that the buttons along the bottom of the dialog are limited to, Save, Clear, and Cancel. There separate dialog `Save' and there is no `Apply' button. Since there are no calendar viewing commands in the Calendar Tool Administration program, setting options does not apply to a calendar being viewed, but to the initial default values for those options for Calendar Tool users, as stored in the Options file.
NOTE: This paragraph needs to be fixed per the latest and greatest options set up. The default option values set by the administrator are available to users in two ways. When running the Calendar Tool, the user can select the `Defaults' button in the `Options' dialog. This allows the user to set options to the default values set by an administrator, as described above.
The other way that administrator-set options values are made available to regular users is through a Calendar Tool program distribution created by the administrator. That is, when an administrator creates a program distribution using the `Admin Distribution' command, the option values that have been set by the administrator are installed in the distribution program as the defaults for that program.
Here's the deal for "inheritance" of options:
Explain how the first three kind of options are ?all? settable by user and are therefore explained in the next section. The difference between what the admin does versus what a regular user does is that under `Admin->Global Options', the admin is setting the global defaults for all users, some or all of which may be changed by users on an individual basis. I think it's also worth mentioning that an admin can be a regular user if she wants to be. I.e., there need not be a special user account that is "the" admin; there can be if that's how a group of users wants to set things up, but there need not be. If an admin wants to be are regular user, she needs to be aware that functions performed under the `Admin' menu have potentially global effects, and must exercise according care in the execution of the functions.
The Admin options are viewable by regular users but settable only by system admins, so they're described here in this section of the requirements.
.sh 4 "Administrative Options"
.sh 5 "Root System Administrator"
.sh 5 "Group Leader Privileges"
A bit of rationale: Since we're nixing pencil in, there was a bit of thought just now that group leaders may not be all that necessary. However, there are other useful reasons to have them. Also, I think it's reasonable to say that group leaders are the only ones who can schedule meetings for which online notification will be sent by the tool. So in effect what we've done is demote pencil power in to notify power.
With that bit of rationale, here are the group leader privileges as we currently see them:
4aug03 Update to the 17jul03 update: We've now got it all figured out, with the new setup for the user record with ID and password, and the way host connection now happens.
17jul03 Update: I don't think the following issue has been adequately addressed yet. To whit, there needs to be some way for a user on a local machine to be validated as a legitimate (registered) user on a Calendar Tool central host. The, I think, so-far unspecified way I've had in mind for this to happen is that the system performs the validation by matching the value specified in the `Computer User ID' field of the Calendar Tool user record with the value of the value of the `Calendar Tool ID'. The problem with this is that if the user is coming from some kind of local computer without a user ID, or that's not passworded, or has some funky convention for user ID names, then this might not work. There's also the issue of security when accessing the central host. With the local-id-matches-caltool-id scheme, there's only the security access at the local machine, which may be considered weak.
In thinking about this, I think there's also a problem with the whole idea of listing the IDs of the local host computers in the caltool user record, particular in the case of access from a machine with a non-static IP address. As I recall, the reason for this is to allow the central host to send notifications to particular users on particular machines, whether or not the cal tool is running on those machines. The idea that this is nice stems, it seems, from Claris' ability to pop up a reminder even if Organizer is not running. However, I think there's a significant difference between this and the ability of a central host to send a meeting notification to some other machine altogether. In the Claris reminder case, it can be implemented with an entirely local "at" daemon of some kind, or the Windoze equivalent. In case of the remote meeting notification, the communication has to go across the wire to some known network address via a PUSH.
So, first off, I now have a significant question about whether the "any time" option is really viable for meeting (and other) central-host-generated options. In order for this to work, either the central host needs to have IP addresses to send to, with a daemon running on the other end, or when a local machine starts up, or when a particular local user logs in, the local machine has to fire up a daemon the communicates with a central host, including performing the user validation that we mentioned above, in order to be able to receive notifications without the cal tool running. On a multi-user machine, this could be a huge problem. Given this, I'm thinking that it's reasonable to say that notifications can only happen when the cal tool is running and when a user is explicitly connected to one or more hosts. So, in order to check if a meeting has been scheduled, one must explicitly connect to the host from which the meeting originates.
So, I'm thinking we need to have a new, and if we're lucky, simpler scheme where the user must provide an ID and password when connecting to any particular central host.
4aug03: And so it is.
4aug03 reply to 26jul03 consideration in the next paragraph: NOT. We require connect with a particular calendar, period. If this is inconvenient for people who want to "just browse", tough shit. Bottom line -- a calendar is a necessary part of the entry ticket to a central host, along with, of course, a registered ID.
26jul03: consider allowing central host connection without a calendar, which means user can look around at other people's stuff but not receive any updates. Hence, all of the places where we say that the user must be connected, we mean "must be connected with a particular calendar".
When the user executes the `Connect' command in the `File'
menu, the system displays the dialog 317.
OLD: Central Host Computer ID: host name, with admin-settable default Status: connected/disconnected Connect Disconnect Clear Cancel
Figure 317: shit.
To connect or disconnect to a host, the user selects the desired row in the list and presses `Connect' or `Disconnect'. When the designated file for a particular host is opened, the system attempts to establish a connection with the central host for that file; when the file is closed, the system disconnects. (See multi-user-envir for more info.) A host must have a designated calendar, i.e., the `Calendar' column cannot be empty and must contain the name of a valid readable/writable calendar file. A calendar can be associated with two or more hosts, but at most one of them can be connected at any given time. If the user tries to connect to a host with an associated calendar that is currently connected to another host, the system displays the dialog in Figure XXX.
Figure 318 shows the user ... . When the user presses connect, the system ... .
If the user has specified a default user ID and password in the options (see Admin Options section), then those are the ones sent to all hosts, i.e., they show up as the default type-ins in the connect confirmation dialog. This means it's nice etiquette in a particular multi-host environment to use the same user IDs on hosts where it's reasonable to expect that the same user will be connecting.
The specific rules for calendar/host association are the following:
Here's exactly what happens when the user connects:
To add a new host, press `Add' to which the system responds by bringing up and add dialog, which if confirmed adds the new host in its lexically sorted position in the list. To change, select item and press `Change' to which the system responds by bringing up a change dialog, which if confirmed makes the change, including resorting if necessary. [The following in-line-editing of change doesn't work because it'd be hard to tell if select meant place edit bar or select for delete: To change, edit a row and press `Change' (the all host and cal columns of all extant rows are always editable).] To delete, select a row and press `Delete', in response to which system brings up delete confirmation dialog. Both add and change enforce unique-host constraint.
OLDER: When the user presses `Connect', the system verifies that the selected host computer is operational, has an active Calendar Tool server running, and that the user is registered with the Calendar Tool on that host. If the verification is successful, the system establishes communication with the chosen host and sends the user's community calendar file there.
The `Central Host' dialog looks like Figure 318. -- NO, it's
been updated
here.
Host Computer ID: (read only) Status: (up or down)
Figure 318: Central host dialog for a regular user.
The central host ID is read-only to a regular user. The ID is set automatically when an administrator updates the user database or changes the central host. Specifically:
OLD: As noted in the introduction, there is a single calendar file that is known to the Calendar Tool system for each user. This is the file named `Calendar' stored in the user's Calendar Tool directory listed in the user's database record. Only items scheduled in this calendar for are visible to other users of the Calendar Tool system.
NEW: The `Local Directory' command allows the user to set the
directory on the local computer where the Calendar Tool looks for standard
files. Cite section that describes the files and say that a normal file
chooser comes up with the message "Enter the name of the directory where the
Calendar Tool looks for standard files:". Also, explain that this file is set
to some typical default location (platform-specifically) at initial
installation.
6.5. Nixed in Favor of Explicit Dialog Settings
But, alas, the next paragraph is full of shit, since we have now in fact put (most of) this stuff explicitly in dialog(s).
During process of creating a distribution, consider allowing the admin to set
up a pre-defined connection table and pre-defined local-files value. I'd say
the best, and most orthogonal way to handle this is to have the admin define an
Initialization file that's included with the distribution. This is in fact a
good idea in general, viz., a distribution is defined a copy of the app itself,
plus a set of standard files. I think this provides a good amount of
flexibility and makes good use of the standard files setup, i.e., it's in
keeping with the philosophy that the standard files fully define a cal tool
config, without any hidden values buried inside the app itself or in some
obscure file (the latter being Microsoftesqe, it would seem).
6.6. What's on the Host
8aug03. It's not just the "public portions" of a user
calendar, whatever those might have been, but all of the user's calendar. The
viewing commands take care of not showing to other users calendar items or
parts thereof that aren't supposed to be visible. An added benefit, though
perhaps a weak one, is that the user can consider the central host copy of the
calendar to be a full backup.
6.7. More nukation from admin, here re. purging and capping
NOT, it's part of the File->-- THIS NEEDS TO BE ADDED TO THE COMMAND MENU. --
For large installations and/or for central hosts with limited storage resources, Calendar Tool administrators can purge scheduled items from the central host calendars of some or all users. Sketch of functionality:
Hmm, if we follow the latest functionality for local-to-central cal copying, it may not do any permanent long-term good to purge without lowering limits as well. So, it looks like we need some kind of coordination with purging and item-limit setting. Shit, one more fucking thing to work out.
For any or all users and groups, can cap the number of items for that user that are stored in the central calendar. When the cap is reached, items are removed such that an equal number of items, +/-1, appear before and after today's date. Notification is sent to the user when the cap is reached, including an annoying message every time it changes, which means the user either has to do something to clear out old junk or ask the admin to increase the cap.
Changing the cap size to a value smaller than the current number of items
effectively executes a purge operation.
6.8. Nuked from Change/Delete Section 28 Jul 03
NOT: The detailed notification dialog reflects change merging when it is initially displayed. Hence, the `Title', `Category', and `Remind' fields in Figure 166 contain the values most recently entered by the user, not the older values that appeared in the scheduler's view in Figure 157.
... This item-level view contains exactly the same data values as Figure 167.
If the scheduler has changed the `Category' field, the category name
is highlighted in boldface font, but in the normal color of the category.
(There is no category change in this scenario.) For all other changed data
fields, the entire field value is displayed in bold red, not just the
individual characters or lines to which edits were made. For example in
Figure 166,
The entire text of the `Details' field is shown in bold red, even
though only two lines of the text have been changed by the scheduler.
6.9. Nuked from Admin Section 27 Jul 03 through 11 Aug 03
Some more old crap:
.sh 4 "Summary of Super User Privileges"
Next several paragraphs are older variants of `Contact Admin'.
Other notes about `Contact Admin':
Here's an older version of a user-to-admin message:
A user can look up the electronic mail address of any administrator using the
`List Admins' and `Users' commands in the `Admin' menu. Figure 319 shows a
typical mail message sent by a user requesting an administrator to make some
changes to the user's Calendar Tool user information.
To: caltool_admin@csc.calpoly.edu From: rich@ailab.calpoly.edu Subject: Changes to calendar tool user information Dear calendar tool admin: I have changed my office computer and email address. Please make the following changes to my calendar tool user information: email: rich@ailab.calpoly.edu host computer: acorn.ailab.calpoly.edu user id: rich caltool directory: c:\home\calendarThanks.
Figure 319: User requesting calendar tool information changes.
Some old crap:
A regular user cannot change any of the values in a user database information record [in the DB dialogs; password can be changed indirectly using the password command.] If a user needs one or more information fields to be changed, the user must request the changes be made by a system administrator. There is no specific Calendar Tool command to make such change requests. An electronic mail request is presumably typical.
OK, a big bunch of stuff has been nuked from the admin section, including a lot blather on the design of the central host. If you're interested, check out admin.me version 1.23, which is a check point with all of the blather before it was nuked. But fuck it, I'll put the juicier bits of fodder here so I don't have to go dredge it out of the CVS log. To whit:
So fuck it again, I didn't feel like putting anything here. Go see v 1.23 if you care (I already have a couple times). Diffing v 1.23 and 1.24 is probably a pretty good way to focus on the juicy bits I was thinking about putting here.
IWe need to remove the ID and Passwd columns, which were recently added, since they should not be stored locally, but rather on the host. So, if we want to change the host password, we need to be connected, which means that leaving the Password command in the regular-user Admin menu is correct.
Central Host ID Passwd Calendar Connected ========================================================================== 19.62.146.83 Personal Calendar csc.calpoly.edu Work Calendar X falcon.csc.calpoly.edu Work Calendar onion.csc.calpoly.edu Lab Calendar X Connect Disconnect Change Password Add Host Change Delete Save Clear Cancel
.sh 3 "User Communication with Administrators"
NOT. To avoid the need for message-handling functionality in the Calendar Tool Administration program, there is no means for a regular user to communicate with an adminstrator via the Calendar Tool. To do so, the user must look up the adminstrators' email addresses using the `Admin->List Admins' command and communicate via email, look up the phone number, or otherwise communicate with the admin outside of the context of the Calendar Tool.
.sh 4 "Listing Administrators"
Describe that `List Admins' shows who all the admins are, Figure 320.
Figure 320: List of Calendar Tool administrators.
The `Validate' button is used to validate user information that is external to Calendar Tool administrative control. This is the information entered in the `Email' through `Computer User ID' fields. Details of the validation are covered in Section
[NO to the following, per the latest revelation the no admin data are ever stored on local user machines see below : In conjunction with the notification message, the Calendar Tool on the new user's host computer is reconfigured with the ID of the Calendar Tool central host.]
Details of central host configuration are covered in Sections and 2.6.6.
In the scenarios to follow, privileged administrator access is covered in Sections 2.6.1 through Section . Access to administrative commands by regular users is covered in Section 2.6.6. In the scenarios, the term "administrator" refers to a user with administrative privileges running the Calendar Tool Administration program. The term "user" refers to a regular user running the regular Calendar Tool program. Also, the term "privileged Admin menu" refers to the command menu in the Calendar Tool Administration interface ( Figure 4 ). The term "Admin menu" refers to the menu accessible from the regular user Calendar Tool interface ( Figure 2 ).
There are two contexts in which administrative commands appear -- in the admin program and after the user establishes a connection in the regular UI.
When the user establishes a connection with a remote host, the `Admin' appears on the menubar. Prior to establishing a connection, or after close all connections, the `Admin' menu is not in the menubar. Since establishing a connection is a precondition to working with the administrative commands, it's described here.
TODO:
OK, the evidently unspoken rationale for having local host user ID be part of the cal tool user record was this. The local machine would provide the user- level access structure, including passwording, and then the cal tool would rely on this in the sense the mapping from local ID to cal tool ID was the only cal tool validation necessary, the user having (presumably) entered a password to gain access to the local machine. The perceived advantage of this is that the user on a local machine does not have to log in twice, once to the machine and then again to the cal tool. There are at least a couple problems with this structure however. The first of which was noticed pretty early on. That is that it's a pain for the admin to have to have multiple local computer potentially listed in the user records. At the same time, it's a pain, or evern unrealistic to require that the user IDs be the same on all connecting local machines. Another problem, which is just now coming to light, is that it is in some circumstances unrealistic to expect a specifi local-side login protocol that the remote cal tool server can rely on. What comes to mind most clearly is the access-from-internet-cafe configuration, where the ID of the connecting machine cannot possibly be known (in advance) to the remote caltool server.
Given these problems, the user model that is better is to require both user ID and password in the caltool user record. The inconvenience of double login can be avoided by allowing the user to specify a default cal tool user ID and password as an option. These will be automatically supplied when a user connects to a remote host. Also, admins on a number of cal tool hosts in a given organization can take care to give each user the same cal tool ID on all hosts, so a single default will work for a given user connecting from one or more local machines. The bottom line here is that the cal tool does not rely on any local-machine login protocol to validate that a cal tool user can connect to a remote host.
The other thing that has to be changed in this new user model is the idea that the regular user interface to the cal tool can know the (local) user ID at start-up time, therefore know the cal tool ID (since it's the same), and therefore know whether to start up the registered or non-registered UI. The deal (now) is that launching the cal tool locally does not in and of itself make a connection to a remote host, even though it might seem to do so by virtue of the auto-connect-on-open option. The important point is that launching the cal tool locally cannot necessarily mean that a remote host connection is automatically being made, and even if it is that a particular single cal tool ID is to be used for the connection. Therefore, automatically matching a local ID to a cal tool ID at start up, or even explicitly requiring al login at cal tool start up, is not generally useful. The login is part of the connection process, not the start up process. Given this, there either need to be two separate "regular" user apps, or we can just forget about the unregisted version, just leaving all of the would-be missing features disabled. Another alternative might be to have the entire Admin menu not appear until a connection, but that can't work with exactly the current Admin menu, since it's got the connect command on it (indirectly). So, it's either two separate apps, or one with Admin permenantly disabled. It's not all that hard to provide two, so what the heck, I think we should just do it.
CONCLUSION: OK, here's the deal. We've moved the `Central Host ...' command from the `Admin ...' menu to the `File' menu, and renamed it `Connect'. Also, we've moved `Local Directory ...' to the file menu, renaming it `Local Files ...'. The point is to avoid the chicken-and-egg problem noted above where we can't get to connect if the `Admin' menu is initially not in the menubar. With these changes, we can say that the `Admin' menu does not appear until at least one successful connection is established. Further, the DBs and admins to which the `Admin' menu apply at any given time are the host to which the current calendar is connected. If the current calendar is not connected to a host, then the admin menu is disabled, but still on the menubar. The `Admin' menu disappears from the menubar when all connections to cal tool central computers are severed.
7jul04 NEW CONCLUSION: Fuck the chicken-and-egg bullshit around the
Admin menu. Just leave it the fuck up all the time, with the DB
commands and passwd command disabled unless the current calendar is connected.
This means we move the Connect command back to the Admin menu
where it belongs. The fact that it belongs in the Admin as opposed to
File menu was brought pretty clearly home when I tried to write a
decent intro paragraph to the Flie section, whereupon it
became pretty darn clear that Connect is only weakly related to file
processing. Furthermore, the fact that I've seen fit to explain the connect
command fully in the Admin section makes it quite clear indeed
that it should be an Admin as opposed to File menu command.
6.11. ``View ...'' versus ``Edit ...'' as Button and Menu Item Names
"View ..." is used when there is more information to see about a particular
item of data. The displayed dialog may allow editing, with Change and
Delete commands, but without an Add command. "Edit ..." is
used when the when the displayed dialog has all editing commands, include
Add. "Edit ..." is the menu item for categories, lists, and filters.
"View ..." is used as the menu or button for other viewing/editig dialogs,
including meeting notifications, meeting minutes, and a few others.
6.12. The Explicit Delay Button in Meeting Notifications
It's clearer than just having the user close the window to delay. It was
decided that a Delay button is not necessary in the item-level view of a not-
yet-accepted item since the user isn't necessarily there to make an
accept/decline decision the way she is in the notification dialog.
6.13. Group Explorer
Thought about adding a tree-style group/user explorer, but it's a bit much given that the group structure is potentially a graph, not a tree. E.g,
While this could be rendered in tree, e.g., via some kind of copying rule, it's more trouble than its worth. Here's some verbiage that was going to go in the Section 2.6.3, including a screenshot of the updated group db GUI.campuslect = cslect csdept = csfac, cslect, csstaff cslect = b,c,f
... To access the group database, the administrator selects the `Groups
...' command in the privileged `Admin' menu. In response, the
system displays the dialog in Figure 321.
Figure 321: Group database dialog with explorer.
When the user presses `Explorer ...', the system display the group
viewing window shown in Figure 322.
This would be a standard kind of tree/graph-based explorer.
Figure 322: Group explorer.
This is the point at which I figured things were going to get out of hand
here. Smart thinking, actually.
6.14. Nuked from Admin; Presumably to Go In Some Form in Installation
sh 3 "Initial System Configuration"
12aug02 Update: Think about moving the last paragraph above here. Or perhaps it belongs in the installation section, with only a ref to it here.
29jul02 Update: I think this section stays, in addition to the high-level installation section. An important point (if not the point) of a cal tool admin doing a config is to coordinate the cal tool app's hard-wired locale of a user's cal tool dir with the convention for it to use in users' cal tool admin user db records.
3jul02 Note: This section may go in favor of the higher-level installation section that's now been added. Still need to work this out fully.
Talk about what things look like straight out of the box to the admin and what needs to be set up. Constrast this to the essentially negligable set up required for non-admin users.
Need to be able to set default for calendar-host mapping, for convenience
of the user. This way, when it comes up out of the shrink wrap, it'll be
config'd.
6.15. Fodder from Wincow Viewing Section, Ca. Aug 02
NOTE prime: OK, it looks like we're going (back) to the rule that a calendar cannot be windowless. This avoids the problem of what window should be current when a windowless calendar is current. This decision obsoletes all of the discussion notes that follow that refer to a solution that assumes windowless calendars are legal. Further, this decision lets us leave the chronological current-on-top layout of the windows submenu as is, as well as leaving the related scenario narrative pretty much, if not entirely in tact. (The bottom line for the "But fargs" that follow is that we'll have both windows and cal lists chrono sorted.) But farg, we need to reconcile the chrono-sorted windows list with the alpha-sorted calendar list. I'm inclined at this point to go with alpha sorting for both, given that things seem a bit twitchy with all the movement in the chrono-sorted list. But farg again, the alpha sorting of the windows lists does not give any chrono information. So, the two kinds of sorting (chrono for windows, alpha for cals) may be OK, given that chrono for cals is a bit funky to determine, since it could be "most recently open" or "most recently active based on window selection". But farg one more time, I think we can define chrono order for cals just fine, it being "most recently visited (i.e., current)" based on window order. I.e., the chrono order of the cals can be defined as a suborder of the cals in the windows list.
NOTE: The new deal is that when a calendar has no active window, the menubar window should be current when the user selects that calendar. This means that we need to adjust our thinking about "current" versus "has focus" in terms of cal tool windows. The (mini) problem is that the command window gets focus a lot, whenever the user clicks on it to run a command, however when this happens, we don't really want to move it to the top of the windows list. Also, even when the menu window is current, there's still the notion of a current calendar, the open window for which is current. Hmm, maybe we need to separate "current window" from "current calendar" even more clearly than we've done so far. Another way to help deal with the issue is to list windows alphabetically in the windows list instead of chronologically, with the current window checked in lieu of it being at the top of the list. Well, the problem with this is that if we consider the menu to be a window, then technically it should always be checked, since it's always physically current whenever the user runs the View->Windows command. Farg.
OK, here's the conundrum we're dealing with: We don't want to make the menubar
window current unless there's a windowless open calendar. OK, how bout we go
back to the rule that windowless calendars are disallowed, or more precisely,
view-windowless calendars are disallowed. (It really doesn't have to be view-
windowless, since the user could open a view, open a schedule dialog, then
close the view, leaving the scheduling dialog as the (sole) window open on the
calendar. This should be just fine, as long as there's at least one cal-
specific window open.)
6.16. Meeting Notifications and Calendar-Host Association
Much thought given to whether notification options should be global (i.e., for the entire tool) versus calendar-specific. Also, some thought was given to having an option to auto-accept scheduled meetings. The first idea was nixed because we do not want to open the global/local option can of worms at all. The second idea was nixed because it can effectively be achieved by leaving the `Not-yet-accepted Meetings' option as `show' and setting the `Accept Notification' option to `never'. In this way, the user is not bothered with seeing the notifications, which is presuambly the point of the auto-accept option. Without the auto-accept option, meetings that would appear in normal type on calendars instead appear penciled in. But this is fine, because it means that if the user bothers to look at the details of the meeting, all she has to do to get it to normal type is press accept (instead of cancel or close) in the viewing dialog.
Much thought was also given to the cal-to-host assciation rules, the possibilities being:
The `Home directory leading path' setting defines the default leading
file name path prepended onto the `Calendar Tool Directory'. If the
path is non-empty, it is prepended iff the value specified for a particular
user is not an absolute or user-relative path, where absolute paths start with
"/" or "<drive-letter>:" and user-relative paths start
with "~".
6.18. Decision about User Control Over Notifications
24jul02 bottom line -- There are two basic categories of notification: meeting
and admin. The user has full control over meeting notifications, none over
admin notifications.
6.19. Some Uncommonly To-The-Point Fodder from the Options Section
Provide a dialog that looks like this:
The idea is that each user can control who she accepts being bugged by for meeting scheduling. But hmm, am having a bit of second thoughts about being able to reject requests from group leaders, since it doesn't make necessarily good sense; it may well be better just to have a user request to be removed from the group. I do still however very much the ability to be able to accept meeting requests from individuals, as the next paragraph attests.OUT: Accept Calendar Tool Meeting Notifications from the leaders of these groups: * all * specific group list, with a radio button beside each, scrollable in case there are a large number of groups defined * none :TUO (see "NO" paragraph below) Accept Email Meeting Notifications from the leaders of these groups: * all * specific group list, with a radio button beside each, scrollable in case there are a large number of groups defined * none Accept Email Meeting Notifications from new groups you're added to: * yes * no Accept Meeting Notifications from these individuals: * all * specific user list * none
But OK, here's a case where rejecting requests from some group leaders makes perfectly good sense -- I'm going on vacation and I don't want my calendar and possibly email cluttered up with meeting requests.
So, here's a nice happy medium -- the leader of a group for whom meeting requests are turned off is notified when the turn off happens. This may be getting overly complicated, but hey so's the whole darn system.
NO, screw the happy medium -- users CANNOT decline meeting notification from the leaders of groups they're members of, only email notifications. If they're gonna participate in the Cal Tool community, they're on the hook for receiving meeting notifications.
NO, NO, users can turn off notifications, as imprudent as it may be. See latest version of meeting scheduling section.
The ability to accept meeting request from individuals effectively allow Cal Sys users the ability to establish unofficial groups, by establishing mutual acceptance of meeting requests.
Some question/details pursuant to the above dialog idea:
When the user presses `Save' the system first performs `Apply' (if it is enabled), then saves all option settings in the current calendar. If no calendar is open, options are saved in the standard `Options' file. As with the `Apply' button, `Save' is initially disabled, becoming enabled when the user changes the options settings in one or more tabs, makes current a calendar with unsaved changes, or loads a new options file. While execution of `Save' performs `Apply', the converse is not true. Therefore, the settings in the options dialog exist in one of three states:
Saving options for the current calendar does not save any unsaved scheduled
items in the calendar. Scheduled items are saved using the `File
Save' command, described in
Section .
6.21. Hopefully Final Nukes for Options
Admin Default shared user calendar file name: [default = "Calendar"] Home directory leading path:
In thinking through clearly how the IPC will work, it must be based on the fact that the host does not have direct write access to the local machines. Something like message passing must happen, along the following lines:
...For User-Entered Data: Font Name: pulldown of font names Size: pulldown of environment-specific ints Style: one of Plain, Bold, Italic, Bold Italic In these displays: one of For thes items: one of Item Appointment Day Meeting Week Task Month Event Year All items Lists Dialogs All displays For Permanent Text: -- same as type-in text --
The user can set font options for two forms of text: scheduled items and all other text. The font settings under `Scheduled Items' apply to the text of scheduled items as it appears in day, week, month, and list views. The settings under `All Other Text' apply to all other text appearing in Calendar Tool display windows, including user-entered text as well as permenant system-generated text.
The `Font' and `Size' data-entry fields are used to enter basic font information. There are two forms of display text for which font selections can be made: typed-in text and permanent text. The settings for typed-in text apply to all text entered by the user in the text-entry fields of dialogs. Permanent text settings apply to all unediable text that appears in displays, except for the text in window banners. Display-banner text is considered to be under the control of the underlying operating environment, and is therefore not settable from within the Calendar Tool.
The font options tab provides no control of font style or color. The normal, boldface, or italic style of text is controlled entirely by the system. The user can change the text color of scheduled items using the category editing features described in Section 2.5.5. No other control of text coloring is available.
The text of warning and error messages is always shown in bold typeface, indepednent of the `Style' option selected for permanent text. The settings for font name and size do apply to error and warning message text.
The `Scheduled Items' settings apply to all text entered by the user, blah, blah, blah. The `Headers and Labels' settings apply to all of the header and labeling text, such as current date, dates, etc, blah, blah, blah
... Describe that font, style, and size entries are platform-dependent, but give some typical values. The `Font Name' and `Size' menus are platform-specific lists of available fonts and their sizes. The `Style' shown in Figure 323.
The `Display Type' pulldown menus specify the types of displays to
which the selected fonts apply. The possible selections are the same for both
menus and are shown in Figure 323.
Figure 323: Font options menu.
To appear.
Figure 324: Font option values selected for month-level displays.
To appear.
Figure 325: Monthly view with user-selected fonts.
Sketch of the remainder:
There's no question we went around quite a bit about how best to do options. We considered making them global for all calendars, calendar-specific but still applicable to multiple calendars at the same time, and the current solely calendar-specific style. All of this is a bit much, given that changing options is not likely to be all that frequent an activity, but we do want to get it right.
There have also been plenty of go-rounds for specific details. Noteworthy considersaions are these:
Methodologywise, the options requirements have been developed thusly:
1jul02 Note. If it's not the case already, and I do not think it is, I believe there should be an option setting for each and every data-entry field in each and every dialog. If this is done entirely uniformly, it seems that we may be able to have the same data-entry dialogs used for default setting as for actual data entry. This could be pretty cool if we could pull it off. -- Done. --
4jan01 thot about 14dec00 thot: Hmm, with movement of prefs to options menu, I'm not sure about the tabbing dialog any more. We may want to put a prefs menu back, with `Edit Prefs' being tool prefs versus the top- level `Options' menu being data prefs. I'm not sure the distinction is worth making, so I guess we have to think about this some more. 24jul02 update -- screw this. --
14dec00 thot (and I think it's quite a good one): organize preferences into a tabbing dialog with exactly one tab for each menu. -- Done. --
Among the other options, there should be some for little things. Here's the beginnings of a list:
Once upon a time, there was going to be a `Defaults ...' button in the options dialog to restore "default" option values. This has been replaced now with `Load ...' button, the dialog for which is given just below. The deal is we now have what are best called "standard" options, in the Options file, rather the kind of "inherited from" default options we had been envisioning earlier.
Once upon a time, we said that: "The three radio buttons at the bottom left of
the options dialog indicate which option settings are currently active". These
buttons are now nugatory, given the current scheme of things, viz., the only
"active" options are those for the current calendar. To make other options
"active", they have to be loaded, and in the current scheme of things, they
become active (and unsaved) for the current calendar only. As rationalized
above, to make a set of options active for multiple calendars, they have to be
loaded separately for each calendar (which can be done with a script, in the
(presumably quite rate) case that we want to do it for a bunch of calendars).
6.26. Here's an Important Bit that Finally Got Handled
This bit is not really in and of itself a part of rationale, but the idea that it's an important piece of information that lingered as only a note for a long time is interesting rationalewise, or someotherwise at any rate. Anyway, here is a note from the options `Times and Dates' section that finally got officially dealt with. Finally dealing with this note led to an addition to the previously-thought-done structural viewing section.
The following are the notes that elucidate the real deal for options. These notes were refined into the current requirements in the Options section. Only the last item of these notes needs to survive as rationale, since all of the other items have been incorporated nearly verbatim in the requirements, whereas the last item appear no where since it's pretty much strictly rationale. OK, try this for how to deal with "global" versus calendar-specific options.
"There are unsaved options for this calendar." (x) Save these changed options for this calendar ( ) Don't save changed options, i.e., leave the most recently saved options for this calendar as is
And the following section was just nuked from the options section, per the explantory 29jul02 remark that preceeds the rest of the notes:
.sh 3 "The Format of Options Files"
29jul02 Update. For doability, we need to abandon the idea of option files being parsable command files, or even user-accessible text files, at leas for now. The reasons are several:
Here's where things started, before the 29jul02 bail out:
This should be, a la emacs, executable commands. Here's a plausible/possible exaple:
Hmm, context is everything here. Having some trouble figuring out how to establish some, whether by arg or "set" methods. Also having trouble figuring out the scripting API vis a vis the current model API; supposedly they're the same, but it looks like java packaging and static versus non-static method syntax could be a serious pane to deal with in a options script file.caltool.options.timesAndDates.set... file.open("PersonalCalendar"); Schedule.ScheduleAppointment( new Appointment( );
24jul02 -- Try this (29jul02 -- italics after each point indicate whether the point has been incorporated (OK) or nixed (NIXED) from the requirments):
Nuked the following idea in favor of a button at the bottom of the options dialog. I think we made the right decision.
NOTE: Add a separated `Save ...' item at the bottom of the `Options' menu. It launches a dialog that asks something like the following:* Save for this calendar only * Save for all calendars Options name: [ .calendar_options ] ( Browse ... ) ( OK ) ( Clear ) ( Cancel )
Note also that this item probably only applies to non-admin users, since for the admin, the options settings are saved as part of the complete set of admin DBs, meaning admin-level options are covered by `File Save'.
The following was a related bit of murky thinking about defaults-related porcessing in the appt-scheduling section. It's (obviously) been refined. Note that the reference to "the preceding two refs" were to places I vaguely understood as where the details of global default setting would go.
To clear all information entered in an appointment dialog, the user presses the `Clear' button. In response, the system clears all typing areas and restores all other data-entry fields to their default states. Details of default settings are covered in Sections and To cancel a scheduling command entirely, the user presses the `Cancel' button. In response, the system removes the dialog from the screen without performing any scheduling action.
[NOTE: The preceding two refs need to be fixed, and we need to figure out exactly what scheduling options include, in particular if they allow default values to be entered for each and every field. Perhaps the easiest and most general solution is simply to have a `Set Defaults ...' button in each schedule options subtab. This button brings up a standard dialoag for each type of scheduled item, with "DEFAULTS" somewhere prominently in the banner or title. I think this is pretty cool, actually, because it will illustrate a nice general and orthogonal way to allow the user to set defaults.]
We need to rationalize how we let the pedagogical goal influence the model
structure of scheduled event a bit, given that we wanted to specify (and
subsequently implement) a "good looking" inheritance struture. This includes a
dicussion of the Event item, which we've gone back and forth with in terms of
exactly what fields it has. As of 9mar02, we in fact have the situation that
the implementation is wrong vis a vis the specs, since the implementation has
location in an Event, whereas the spec has SimpleSecurity. This component
change to Event apparently happened on 16jul01, according to the CVS log entry
of that date for version 1.17 of schedule.rsl. The only explanation of what
was evidently some deeper thought on the subject was "Removed Location and
added SimpleSecurity to Event (this being a significant update).". I guess the
thinking was that location doesn't necessarily make sense for an event,
particularly for things like holidays, as well as for the example events we
have in the scenarios, like "Jim's birthday". Anyway, this biz should be
discussed here. Yes, we just did, and so just a bit of "grooming" of this
discussion needs to happen before we release this tome.
6.30. A Feature Removal (!)
The following started out to be an Advanced Option, but as the bulleted items indicate, it's not needed.
A useful but low priority option would be to find all events that have reminders turned on. This would be useful to me because I may have accidently turned on a reminder when I didn't want to, or forgot to turn on a reminder for something I should have. Anyway, this is a low priority requirement.
Ah, but we can do this pretty easily as follows:
Removed the `List Admins' command in favor of having an a`admins' group that has the IDs of all users with admin privileges.
The following was decided to be too cumbersome:
The `Members' and `Leaders' lists are editable by direct typing. To add, delete, or change a user from either list, the adminstrator performs the appropriate typing.
The following was enacted as stated, and this paragraph is a bit of rationale, perhaps:
what happens to all of the meetings for a group when the group is deleted; I think the group name just stays there; hopefully we haven't provided a way for the user to double click on an attendee group to see its information; if we have, that has to give a "the group no longer exists" error message when executed on a deleted group; otherwise, we just have the somewhat funky state where a group name is in a meeting, but if the user goes to look up that group it won't be there; this will have to be the only indication to the looking user that the group has been deleted
This stuff got nixed:
[Include a field that allows the existence of the group and/or its membership to be kept private. Also include confirmation protocol that allows the intended group leader to accept or decline becoming group leader.]
When the administrator assigns one or more users to be a group leader, the assignment does not take effect until the assignee(s) is(are) notified and confirm the assignment. Specifically, when the uGroup Add command is confirmed by the administrator, a confirmation request is made to each of the assigned group leaders. The form of the confirmation request depends upon the current setting of an assigned leader's reminders options. Specifically, the confirmation request is sent immediately as an on-screen pop-up window if the assigned leader has `on screen' selected as the default value for receiving reminders. For any other setting default reminders setting, the system sends the leader confirmation request via email.
To avoid the potential difficulties of interfacing the Calendar Tool with a variety of different email systems, blah, blah, blah ... .
Figure 326: New group leader confirmation.
.sh 4 "Group Membership Requests"
An individual user should be able to:
Recall that all intances in the same collection must have the same start and
end dates. To see why this is necessary, consider the case where some
instances in a collection, call them "Part A", have an later start date than
other instances, call them "Part B". If this were allowed to happen, then the
calender would have to appear inconsistent from the perspective of either Part
A or Part B. If the later end date of Part A is considered the correct, then
there are later items in the calendar than any of the Part B instances
indicate. Hence, when locating at a Part B instance, the end date is
inconsistent with the items that are actually in the calendar. Coversely, if
the earlier end date Part B is considered correct, then the Part A instances
are inconsistent with the calendar, since they indicate that there should be
items in the calendar that are not there.
6.34. Rationale for Changing and Deleting Meetings
Discuss all of the issues related to scheduler and non-scheduler change and
delete. There's a boatload of fodder below that needs to be dragged into
here.
6.34.1. From the end of the change and delete section
.sh 4 "Changing the Status of a Recurring Item"
At least some of this section is wrong. It should be nuked entirely.
When the user changes the status of an item from non-recurring to recurring, or vice versa, the change has a more global effect on the calendar than does a change to any of the other data fields.
When the user changes an item from non-recurring to recurring, what was a single item becomes an instance of a recurring item. When the change is confirmed, calendar and list views may have multiple new items added to their displays.
When a recurring item is changed to non-recurring, the effect varies depending on the scope of the change selected in the change confirmation dialog. When just one instance is changed from recurring to non-recurring, that instance becomes a single non-recurring item, dissociated from all other instances with which it was previously associated. All other instances except the changed one remain as associated instances of the same recurring item. Any subsequent changes made to the changed instance have no effect on the formerly associated instances. Changes made to any formerly associated instance have no effect on the changed instance, but do have an affect on the remaining associated instances.
When all or all future instances are changed from recurring to non-recurring, all of the affected instances become single items, dissociated from all other previously associated instances. Subsequent changes to any dissociated instance affect that instance only. In the case of a change to all future instances, subsequent changes to a still-associated past instance affect all past instances, but none of the dissociated future instances. .sh 4 "Changing and Deleting Past Items"
There may be something to say here -- not sure right at the moment.
6.35. From the task scheduling section
The following issues were all dealt with as appropriate.
..., subject to the following restrictinons:
Refer to all fields that are in common with appoinemts, which should be all be completed and completion-date. Do two or three scenarios for these fields and we should be done.
The following was moved from the task item viewing section, since it appears pretty clearly to belong here instead.
More notes based on task viewing work:
Of note in Figure 91 is the "[2]" suffix in the `On' date
field. The suffix indicates that this is the second meeting scheduled by
estier on the same date. The suffix number is increased for each additional
same-date meeting made by the same scheduler. The suffix ensures that the
`Scheduled By' and `On' fields provide unique identification
for the purposes of changing or deleting a meeting, as discussed in
Section .
6.37. Possible fodder for meeting change/delete section rationale
[in the sched delete confirmation dialog] The user may edit any data fields accept `Scheduled By' or `On'. Performing edits is only meaningful if the user plans to decline the deletion. The user may choose to do so if she wants to retain a copy of a cancelled meeting.
The following was improved by the policy of disabling scheduler-changed data fields in non-scheduler item-level displays with not-yet-accepted scheduler changes:
While it may be imprudent to do so, the user may continue to change his own copy of a scheduler-changed meeting, prior to accepting or declining the scheduler's changes. A particularly imprudent sequence of actions would beSince the system retains the most recently changed data values, this action sequence could override scheduler changes that the user never sees. And blah, blah, blah about a bit of the rationale behind this.
- changing a critical data field, without first viewing the scheduler's changes in the notification dialog
- pressing `Accept' in the item-level display, again without viewing the notification dialog
The following was way too simple an explanation for what it was aimed at:
Explain that for the accepting user, accepting the notified changes has exactly the same effect as if the user had made the changes herself to her own calendar.
The following turned out to be wrong, since we show scheduler changes and deletions in penciled-in form on users calendars:
Explain how attendee display screens are updated. Viz., changes don't happen until acceptance of change/delete notification.
The following turned out to be too complicated, since we went the most-recent change route for merging scheduler changes:
Deal with the issue of what happens when the user has changed one or more data fields when the notification arrives. It probably needs to be some kind of diff3 deal.The next six paragraphs were unrefined issues appearing in the non-scheduler change and delete section. The issues have all been resolved, one way or another. A good rationale discussion will/would discuss which ideas were refined and which rejected.
Any critical meeting change made by the scheduler must be reported to all attendees. As discussed in the next two sections, individual users may decline to receive notifications or change their own copies of meeting announcements. The policy upheld by the Calendar Tool is that the scheduler's version of a meeting is considered to be the definitively correct version. Attendees are always notified of scheduler changes, which they may deal with as they see fit.
Change restrictions are imposed on a meeting scheduler because the scheduler is considered the responsible party for the meeting and it has to make sense there, ... or something like that.
An individual user can change any fields of a group meeting (except `Scheduled By' and `On'), since the user owns the item. The user can even do stupid things like change or remove attendees, or other changes that may not make good sense. It's up to the user. Any such changes are reflected only in the individual user's copy of the item. The official record of the meeting is the one that appears in the user calendar of the user who scheduled the meeting.
Or maybe it's a bit more sensible to allow only some of the fields to be changed, viz.: category and reminder. Changing any of the other fields is arguably non-sensible.
OK, here's the deal. If for some reason, the scheduler cannot or does not want to use the Calendar Tool to notify attendees of a meeting change, then it does in fact make sense to allow individuals to change all fields. The following warning dialog probably makes good sense to make things all nice and happy:
Changing any of the following fields makes your versionThe only fields that cannot be changed are `Scheduled By' and `On', since these is the permanent record of the original scheduler and schedule date, which serve as the unique identifier of the item on all users' calendars.
of this meeting inconsistent with the scheduler's version:
(Start) Date, End Date, Start Time,
Duration, Recurring, Location, Minutes
Or maybe we don't want the scheduler to have to be the attendees' nanny. I.e., we don't care if an attendee deletes a meeting. Attendees are assumed to be grown ups that can come to a meeting or not. If an attendee wants to inform the scheduler that s/he can't make it, then the attendee can do it through some means of communication outside of the Calendar Tool. I'm leaning towards this, just to keep things from getting out of hand notificationwise. I.e., not having attendee cancellation notifications go to the scheduler will make things less cluttered.
Do these examples:
Basically, the same rules should apply as for individual meetings (see Section 2.5.2), but with the wider-ranging consequences of having to notify all participants.
The dialog for changing or deleting a recurring works a la Claris. When a
leader changes or deletes a group meeting that she scheduled, a dialog of the
form shown in Figure 327 appears.
You are the scheduler of this meeting. Do you want all attendees to be notified of the change?
Figure 327: Changing or deleting a meeting as leader.
We (?may/probably?) also want to allow for someone other than the original scheduler to cancel a meeting, which seems most sensibly restricted to leaders of the at least one of the groups for which the meeting was scheduled. While this may weaken the cancellation security a bit, it's probably the easiest and most sensible way to do it, without getting involved with some big complicated deal like what precentage of attendees you must have control over in order to cancel a meeting. The issues we need to deal with in this regard are the following:
Somewhere in here, talk about changing minutes locations for recurring
meetings. A reasonable scenario is edit each individual meeting record with
the specific file in which minutes are held. At the exact moment of this
writing, I'm still thinking about whether to allow directories for minutes of
recurring meetings. If this subsequently gets figured out, then we'll deal
with it here accordingly.
6.38. Possible fodder from appt changing section
As the dialog explains, the user is being asked to select how many of the recurring instances to change. If the user selects `This one', then only the single instance shown in the item-level display is changed. All other instances remain unchanged. If the user selects `All', the system changes each and every recurring instance per the edits made in the item display. If the user selects `Future', the system changes the displayed instance and all future instances. If the user selects `Cancel', no changes are performed. For any selection, the system removes the confirmation dialog from the screen. For any selection except `Cancel', the system changes the button state to the initial configuration. For `Cancel', the button state remains unchanged.
In this scenario, the user selects `This One' in the confirmation
dialog, whereupon the system proceeds with the single-item change and all
necessary view updates.
6.39. (Weakly) Possible fodder from meeting item viewing
Depending on the user who is viewing the meeting, different data fields are
editable. Specifically, the scheduler of a meeting may edit all data fields
except `Scheduled By'. User's who are not the scheduler may edit some
of the data fields.
Figure 137
shows the case where a non-scheduler is viewing the meeting, with the non-
editable fields disabled (the edit fields have grey borders). Further details
on editing scheduled meetings are covered in
Section 2.5.2.
Selecting a recurring item for viewing is the same as a non-recurring item.
Namely, the user selects the desired instance in the current display window
then excutes `View Item'. For example, Figure 328 shows the user
having selected the October 1 meeting instance in a month-level display.
6.40. Possible fodder from task item viewing
Make note also of the fact that task titles are integer-enumerated in day
and week views, not so enumerated in month views or lists. This is a Clarisism
that we may want to reconsider. (Update: nope, we aint' reconsidering it at
this late date, having drawn all of the task view pictures this way.)
6.41. Possible fodder in the area of external file viewing
The following was nuked from the meeting scheduling requirements:
The `Browse ...' button next to the `Minutes' text field leads to a file browser, of the form described in Section 2.8.2 The browser is used to select the name of a file or directory that will hold the minutes. If the minutes are to be located in a URL, the scheduler can browse for the location in terms of a file name, and then type the additional URL prefix in the text field. Alternatively, the scheduler can type the entire file name or URL without using the browser. The minutes field is optional and may therefore be left blank.
The following was nuked from the item-level meeting viewing section:
The figure shows the default form of minutes display in plain text form. As an option, the Calendar Tool system administrator can select an extern program for viewing minutes, such as a web browser. Selection of such an external viewing program is explained in Section .
It is entirely the responsiblility of the scheduler to name the files in such a
way that users can discern which minutes file applies to a particular meeting
occurance.
6.42. 2aug01 -- Nixing the notificaiton enabling stuff (then not)
But "oh contrair" to what follows. Per latest version of meeting scheduling stuff, users can in fact decline all forms of notification. Rationale needs to be written accordingly.
OK, I think I'm ready to forget about the whole user-enabling of meeting notifications, and simplify it to these rules:
The deal about only group leaders being able to schedule for a group seems pretty sensible to me at this point. The deal is that if someone wants to be authorized to schedule for a group, it's easy enough to be added to the leader list for that group.
The bottom line is that it's pretty much like email, in that anyone can send to anyone else. There's a bit more in favor of receivers in that only group leaders can define aliases to send to. There's a bit less in favor of receivers in that "penciling in" can be done, which is a bit more "personal" than just dropping something in a mail box. However, it really just looks that way, in that it's not really writing on another user's file. After some usage, we may want to allow users to have an option to disallow penciling in. OK, I think I just talked myself into providing the option to at least toggle penciling in on or off.
The following verbiage was nuked because of this nix:
Meetings scheduled by group leaders have an official status that meetings scheduled by non-leaders do not have. Specifically, the following apply to leader-scheduled meetings:Further details of these matters are covered in upcoming scenarios.
- notification is sent to all attendees
- the meeting is added to the group calendars of which the scheduler is a leader
- the leader may make changes or cancel the meeting for all attendees
- when an individual attendee deletes a leader-scheduled meeting, the leader is notified
Sketch: The scheduler wants to schedule a one-time meeting among some Cal Tool users. There is no user group defined for the attendees and the scheduler does not have notification priveleges for any of them. Hence what the Calendar Tool can do is find some meeting times, and the scheduler can notify the attendees externally. So, the scheduler tries a narrowish range of possible times and comes up empty. The scheduler then widens the times, finds some, and makes a choice.
When scheduler is unauthorized to schedule a meeting for one or more attendees, the system displays a dialog of the following form (this should most likely go in error conditions section):
A scheduler is authorized to send (via the Calendar Tool) to user X if either of the following is true:The following attendees will not automatically be sent meeting requests because you are not authorized to schedule a meeting for them: ...Explain that the Caltool requires one of these forms of authorization to avoid (in)advertant spewage of mail by unauthorized Cal Tool users. Furthermore, the receiving users will have explicitly authorized the the Cal Tool to send them msgs when they either accept group membership or set their options to allow meeting announcements from selected Cal Tool users. This user acceptance is an important piece of non-spam business.
- she is a leader of a group of which user X is a member
- she is listed by user X as one of the individual users from whom meeting requests are accepted (see Section ).
The meeting scheduling auto-notification rule is the following: a Cal Tool user must take some explicit action in order for the Cal Tool to send a meeting notification. That explicit action is one of the following: accepting membership in a group; setting an option that authorizes a particular Cal Tool user to schedule meetings for the granting user. The point is to strike a balance between the following: (1) want to give users control over from whom they accept meeting notifications; (2) want to allow non-leaders to be able to schedule occasional meetings based on users calendars.
Users can elect not to receive email notification but not cal tool notification. The only way not to receive cal tool meeting notification for a group is to be removed from that group. The way not to receive meetings scheduled by non-leaders is not to set the option the default for which is off.
Here's a bit of overly complicated spec for the possible meetings time list that may be of some historical interest:
The items are sorted in the three separate sections:
The following notes were removed from meeting-scheduling; there may be some useful rationale fodder in them.
6jul01 IMPORTANT NOTE: An important realization that I'm coming to is that the idea of allowing group leaders to physically "pencil in" is probably a major invitation for security breaches and implementation problems, which means I'm inclined at this point to say that there's always a dialog that pops up during or at the initial lanuch of the tool that asks the user to accept or reject a scheduled meeting. In this way, group leaders, including the maximal leader, can never directly write on any user's calendar.
Thots:
This was wacked from the task-scheduling section:
17dec00: I think we want to include a due time for tasks. Don't think we need durations. The motivation is for reminding, including being reminded in a smaller granularity that a whole day. The time can be left blank, in which case it defaults to the currently set value for the end of the normal day range setting. (I think the last bit is pretty cool and sensible, actually.) 10jul01 update: As cute as the last bit is, it goes because tasks without a time are considered to have times latter that all those with times, per latest details of list sorting. Keep it simple, dickhead.
Here's the basic story we want to tell:
Some frank and 100% truthful discussion goes here.
6.48. Filter Dialog Layout
Pretty darn complex. Thot about trying shortest/longest pair, but decided on current form because (a) it can be shared with task priorty; (b) expression is nice and general and with the popular advent of search engine query exprs, the concept of a search expression is not entirely foreign to what might be considered typical users.
At this point, I'm not 100% clear on the relative expressive power of various forms of GUI versus text expr, and I don't think I want to be. E.g., what are the ease-of-use versus power trade offs in a smalles/largest numeric par GUI versus a bool expr text box? I thought about it plenty and am happy with the result.
Specific actual issues in this case are:
See (and discuss here or elsewhere).
In an earlier version of the requirements, the following statement was made in Section 2.3.2.1 regarding the behavior of the next and previous arrow buttons vis a vis the behavior of the `Next' and `Previous' menu items:
"... Pressing one of these arrows has the same effect as the corresponding menu command, with one exception. The exception is that the setting of multi-window mode is ignored when the arrow keys are used. That is, pressing an arrow key always changes the display in the window to which it is attached, and never displays a new window."This statement was removed on the grounds of non-uniformity of behavior. The original rationale for having the non-uniform behavior (i.e., arrows ignore multi-window mode) was solely one of UI ergonomics. Specifically, ergonomically it is nice to leave the mouse in the same place when traversing via the buttons, so the user can just "stand" on the same button and keep moving along. The reason this is not an issue when using the menu command is that the user has to have moved the mouse anyway.
"Mouse-steady" traversal could be achieved in multi-window mode by having the windows stack up directly on top of each other, but this should be rejected as too easy a way to have invisible windows pile up on the screen.
In the end, we figured that it is easy enough for the user simply to turn off
multi-window mode to get the ergonomically desirable behavior. In general, the
presumption is that multi-window mode will be off far more often than it is on
anyway, with users turning it on temporarily to set up a particular form of
side-by-side display, and then turning it off. Hence, the disadvantage of non-
uniform behavior is greater than an ergonomic inconvenience that can easily be
avoided by changing an option setting.
6.51. Precise Behavior of Next and Previous at the Item Level
The exact behavior of `Next' and `Previous' can be specified in a number of ways. Two different behaviors were considered in these requirements. The behaviors can be characterized as an all-item traversal versus a type-specific traversal. In the all-item style, `Next' and `Previous' traverse through a list of all scheduled items of all types. For example, consider a schedule consisting of the following three items: a 4PM Monday appointment, a 9AM Tuesday meeting, and a 10AM Tuesday appointment. Consider also that the current display is the 10AM Tuesday appointment. In the all-item style of traversal, pressing `Previous' changes the display to the 9AM Tuesday meeting. In the type-specific style, pressing `Previous' changes the display to the 4PM Monday appointment.
As explained in Section 2.3.2.1, the all-items style was chosen. The rationale for doing so based on the following considerations:
The would-be rationale for choosing the item-specific style was based on the following considerations:
The time range; times not in the range will not appear at all until the option value is reset; I'm considering a quick command to toggle between full and reduced display, but maybe it's really just as easy to change the option. This is really a minor ergo matter, but worth considering for its perhaps general applicability. To whit, the reason that a separate toggle-full-partial view command is useful in addition to changing an option setting is that it's typically not that easy to change back to a previous option setting, even with general undo/redo. I.e., the user would go to the options, find the option for how man hours to display in the daily view, change that to 'show full', with presumably a quick way to select 'full', then go back to the daily display. But then if the user wants to change back to the restricted range that was the previous option setting, there seems to be no quick way to do this based on general commands such as undo. We might want to postulate some general way to do this, but it seems rather esoteric and a case where we're trying to get a bit too scientific in the UI design for our own good.
We should consider allowing time range to be changed for a single appt, affecting only a single display, as well as for the full calendar, affecting all daily displays.
What fields of the scheduling details are displayed; depending on how carried
away we get here, we could lapse into UI building, which I do NOT want
to get into in this version of the system. OK, let's not get carried away at
all; here's the deal. The only options the user has for display is (i) whether
or not the actual time is shown along with the title, (ii) whether or not
duration arrows are shown, and (iii) whether or not dashed lines are shown.
The precise position of the dashed line is up to the system. A funky thing
that can happen is for a really short event, the text height of the event title
may be physically taller (in terms of time displacement) than the duration of
the event. In order to keep this from happening, the system will automatically
adjust the height of the daily display based on the granularity of the time
division option set by the user. Specifically: (i) the display always shows
one hour granularity of labels; (ii) the height of each hour is equal to one
text-line -- NO this sucks -- there should either be no setting of time
division at all by the end user (i.e., get rid of the option), or the option
setting should only be used to prevent a meeting from being scheduled of a
particular duration, but in any case, the time division option should not
affect the height of the display. Rather, if a user schedules a bunch of
really short meetings within one hour, then some little micro scroll bars
should show up in the individual hour that is affected and/or the hour should
grow to a different size wrt to the other hours in the day and then if
necessary the whole day can be scrolled down to see other hours. YES -- I like
the last of these ideas. Viz., that the height of an hour within a day will
grow if necessary to show all non-overlapping appts that start (and end, except
may for the last), within that hour. The default height for an hour should be
two lines, based on the height of the current font. One last thing about the
duration arrow -- it won't be drawn if there's not enough vertical room based
on the height of an arrow head and some reasonable default for the minimum size
of the line tail of the arrow.
6.53. Start/End versus Start/Duration, Revisited
Below it says we've gone start/end time, but I'm leaning towards going back to start time/duration, given that it makes more sense overall. The specific reasons now are: (1) we liked it better in the first place, and I think there was a good reason for this that I've forgotten; (2) the late-night appointment thing is infrequent, but important enough; (3) the major conceptual problem of distinguishing multi-day recurring from multi-day single I'm pretty sure will be a non-issue when we think it through.
OK, here's the gist of what we've been worried about recently. There's a consistency problem with tasks vis a vis other items when it comes to the due date, particularly with a recurring task. Viz., if there's a fixed due date for a recurring task, what does this mean the due dates are for the tasks that recur. Though I've not looked into it perhaps to the total depth necessary, it appears that both Claris and dtcm have problems here. It's particularly noteworthy in Claris, where in the Task creation dialog, 'Due Date' changes to sense at all.
A related problem is in the creation of the generic ScheduledItem object. Yes, we know of course that inheritance should not drive requirements, but the other way around. That said, there seems to be a good reason for inheritance in the modeling sense, since we would like to use the notion of a generic scheduled item in sorting, and probably other cases. What's useful about generics in these cases is that we can refer to common fields shared by all of the objects. Anyway, if we go for tasks having due dates instead of (start) dates, the structure of the generic scheduled item starts to break down. What happens is we can change the StartDate component to just "Date", but this then lacks modeling power, since the generic "Date" field is in fact interpreted as "Start Date" or "Due Date" in specializations. An alternative is to name the type of the generic field StartOrDueDate, but feels like it's getting pretty hokey.
The serendipitous solution to this mini-mess appears to be the consistent use
of duration in all items. In appointments and meetings, it has the obvious
meaning, and the UI provides hours and minutes to enter its value. In tasks,
the meaning of duration seems pretty clear as well, plus the definition of "due
date" is the sum of start date plus duration. This seems to be quite sensible
indeed, and the only small drawback is that the words "due date" don't appear
explicitly in the task scheduling dialog. However, we may well use the term
"due date" in other UI windows, such as some form of task list. (Though such a
list may not happen in version 1, for the sake of simplicity.) Also, the UI
for duration of tasks and events can include a days entry box (and maybe nix
the minutes box), since tasks and events typically span days, whereas
appointments and meetings do not. So, the conclusion here is using duration
instead of end time seems to work very well overall, and serendipitously allows
the ScheduledItem object to be nicely defined.
6.54. Start/End versus Start/Duration (Older Ideas)
We've gone to start/end, since it appears to be the method used in other calendar systems. The reason is probably because of the underlying conceptual problem with start/duration with respect to scheduled items that span a single day. In one sense, it would be nice not to restrict an item to be within one day, particularly for night people who do regularly do things around midnight. Evidently, since there aren't a lot of people like this, calendaring systems don't care that scheduling a meeting to start at 11PM and last to 1AM the next day is a problem.
However, the deep conceptual problem is distinguishing between a multi-day
recurring event from a multi-day single event. We need to think about
this. And I'm not just falling off here -- I really haven't thought it out
fully nor do I want to right now.
6.55. Big Issue about Factoring Options
Well, we've never fully come to terms to what exactly an option is and how it should be represented in a UI. This issue comes a bit more into focus when we consider whether UI access to options should be distributed across command menus and individual dialogs and/or centralized in an "centralized" `options' menu. There's more to say and think about here.
27jul02 update: cWell wonder of wonders, I do believe we have come to a firm
and quite satisfactory decision here.
6.56. Old Remarks from the List Viewing Section
OK, what we need to do is make sense of applying filters to both calendar and
list views. I think this can be perfectly sensible, in fact. A potential
oddity is filtering a calendar view by date range, since this type of filter
seems to make more sense for lists, where it's a way to shorten the lists.
However, upon a bit of reflection, a date-filtered calendar view is probably
just fine if it means that filtered-out items simply don't show up in whatever
calendar views are showing -- which come to think of it is just the normal
meaning of filtering (duh). So, for example, if we filter out all but a
particular range of dates within a month, in the month view the filtered-out
dates are simply displayed as blank. This sounds just fine to me. In the
scenario, we'll go through all the other forms of filtering and ensure there
sensibleness in both calendar and list views. Cool.
6.57. Filtering Issues
This is potentially a rather complex area. In the style of dialog chosen, one of the key alternatives is whether the "Apply filtering to" choices are one-of radio buttons or multi-select check boxes. At first, the Emacs user in me wanted to make them check boxes, but this is really overly complex and potentially confusing to the user. Hence, for simplicity sake we changed to one-of radio buttons.
The trade-off here is a pretty straightforward of power versus simplicity. The even more specific pro/con is that with check boxes, it's easy to define the same filtering for two or more types of item, whereas with radio buttons the user must repeat the defs for each type. However, the complexity of how consistently to define what selecting one after two have been selected means is high, and any convenience gain is outweighed by the complexity. Plus if we analyze things in terms of how frequently one is likely to do this, the decision was to keep it simple. The future work section discusses the broader issue of much more powerful filtering capabilities.
Here's something that was item under the heading "sketch of ideas" in the filtering section; it may or may not be useful here:
I don't think the named filter menu is a good style of UI, primarily from a convenience standpoint. The main issue is that it requires the user first to define a filter before using it at all, when naming and storing a filter is likely to be secondary for most users. Rather, the primary thing they want to do is define a quick filter, and then after they've used it, save it if it appears to be particularly useful. So, what we need is a filtering dialog that's very simple at the top-level, and allows more advance form of filtering as a second-level option.
Per the latest thinking, there are no yearly interval details. The yearly
interval is simply an on/off setting indicating that an item recurs once every
year on the same date.
6.59. Maximum Date Range
Some interesting variations happen here in different systems. Claris just plain blows it. Emacs specifies that 0 is the min, and has a very large max, but blows it at some point (I've not experimented exactly where) due to int overflow error.
Yahoo calendar does not provide a 'Goto Date' of any form, so it is limited to whatever is predefined. Netscape quits at 1990 and 2037, not exactly sure why. I've yet to investigate what outlook does.
It might be argued that as long as the tool doesn't blow up, it shouldn't
really matter how it behaves "on the fringe". However, I would argue that a
quality tool should never output "bizarre" results, even when the results don't
really matter.
6.60. Lists
28dec00 Ed. Note: I'm leaning towards losing the 'Format ...' item at the
bottom. The rationale is that we can allow the user to control which columns
are visible in an custom view, but don't need to for the fixed views. The
problem with allowing it for the fixed views is that it'll be redundant with
what you can do in the custom views, and probably confusing. There may not be
a perfect solution here, so we should just get on with it.
6.61. Canonical Modeling Form
Interestingly, it looks as if the cannonical simple-print form may (or could
have) shed some good light on the canonical modelling form, with respect in
particular to how to model recurring instances.