The Interface


When a reader requests a page, they will receive the page with a few additions. Along the top of the page will be three buttons: "Add", "Search" and "Help". Any existing annotations will be marked with small arrows on either side of the annotated text.




Adding Annotations





If the reader clicks on the "Add" button, a pop-up window will appear to add a new annotation. In addition, if the reader happens to click on "Add" while the Add window is already open, there will still be only one pop-up window. The window will simply pop to the front and load the "Add an Annotation" page. Since the program already has the reader's name and email address, the only information the client needs to supply is:

For the permissions, annotations can be public, private or semi-private. If the client chooses semi-private, he/she must also choose the group(s) that have access to the annotation.

There is also an option to include HTML in the text of the annotation. For instance, the author may wish to add links or list elements. They can do this by checking the "Treat text as HTML" box.







Viewing Annotations



If the reader clicks on the arrow, a new window appears displaying the annotation. The Annotation window has a top and bottom frame. In the top section, the original annotation is displayed with buttons to reply to the annotation or close the window. If the reader chooses to reply to the annotation, the window will display a modified "Add Annotation" page with text fields for the title and text of the reply. When the client has submitted the reply, the window displays this new annotation.

In some cases, there is a third button displayed in the top frame of the Annotation window. This is the delete button. Only the author of the annotation and the system administrator have permission to delete an annotation. This is the only time this button appears. In addition, when the delete button is pressed, if there are any replies to the annotation, the system will not let the client delete it until all replies have been deleted.

In the bottom of the Annotation window is a collapsible reply tree (See Figure 3). An arrow pointing to the right means there are replies to that annotation, and an arrow pointing down means the replies are already shown. To view a reply, the reader selects the title of that reply in the tree. The text of the reply will be displayed in the top frame, replacing the original annotation.