Reading HyperDocuments

Annotations in DocReview

HyperDocuments are designed to augment your reading with additional information.  The information is presented in popup windows which allow the reader to obtain additional information about the content of the document without leaving the current HTML page.  The windows may contain footnotes, sidebars, bibliographic information, glossary definitions, internal links, or "sticky notes" which mimic those little yellow stickers.

HyperDocuments pop up new windows when you click text anchors colored gray or black rather than blue. You can tell what kind of information is offered by reading the status line at the bottom of the screen. Internal hypertext links to other parts of the HyperDocument are either clickable icons or standard blue text. Hypertext links to other documents are rare, since the "sidebar" will bring up the referenced page in a new window.

If there is a reference section (bibliography) and/or a Notes section at the end of the HyperDocument, there will be reverse links from the citation or note to the place(s) where they originate in the text. Those of you who read the bibliography first can really benefit from these links.

Types of text anchors:

Sidebars
Sidebars are text pages larger than typical notes, often large web pages. Sidebars are anchored by gray text underlined, for instance: HTML markup for simple tasks, such as making paragraph bereaks and emphasizing some text, is a minor skill easily mastered in a tutorial offered free of charge from the Maricopa Center for Learning and Instruction. Try it.
Footnotes
Footnotes are classic marginalia. They are additional points of information somewhat more important than references. Footnotes are anchored by underlined gray numerals in the text, for instance: Notes may take the form of footnotes, endnotes or sidenotes 1 .
Citations
Citations are bibliographic references. They are underlined gray text in parentheses. Clicking a citation pops up a full bibliographic reference in a new window. In that window is a button "Go to Catalog," clicking on that button takes you to the "Catalog Card," another window with the full bibliographic information, an abstract (if available), annotations about the work from your collaborators, and buttons which allow you to contribute your annotation or read the full text of the work (if on the WWW). Here is an example: The recent expansion of the Internet's capabilities in both communication capacity and diversity in genre categories (Agre 1995) has fueled an explosion in collaborative capabilities.
Glosses
Glosses are definitions, or technical comments on a word, from an enterprise glossary. The anchors are words or phrases in italic gray text. Clicking an italic gray word or phrase pops up a "definition card" that contains the definition, any commentary on the definition, and buttons which allow you to contribute your comments on the definition. Here is an example: A research web essay eventually evolves into a canonical document.
Notes
Sticky notes are a general purpose note used for whatever purpose the author chooses. Notes are anchored by bold gray text. Typical uses are for note bene that do not warrant footnotes, glosses in documents that are not supported by an Annotated HyperGlossary, or bibliographic information in documents not supported by an Annotated HyperBibliography. They can be used to pop up images if you write the proper HTML in the note. Here is an example: Information on this service has been hard to come by.

Handy Hints





References

Agre, Phil. 1998. Designing genres for new media: Social, economic and political contexts. In CyberSociety 2.0: Revisiting CMC and Community. Editor Steve Jones. Sage.  




Glossary of Terms

Canonical document -- An authoritative document. In the context of Research Webs, the canonical document is an essay that incorporates or references the accumulated knowledge about a topic as interpreted or synthesized by the research team. --- (C. Hendricksen)





Notes

1. Classic footnotes are placed at the bottom of each page and numbered from (1) on each page. They cannot be employed in hypertextual documents because hypertext documents have no pages! End notes are placed at the end of the document and are numbered consecutively. HyperDocument footnotes share some characteristics of the classic endnotes since there is a summary of the notes at the end of the document for the convenience of the reader that chooses to print the document for reading offline. Sidenotes are placed in the margins of the paper document. They were extensively used in theological manuscripts. HyperDocument footnotes resemble sidenotes since they pop up in a new window which can be moved to the side of the main HyperDocument window.