I spent about 60% of my work hours last year selecting a thematic collection of 330 cultural heritage objects and interpreting and explicating facets of those objects in a set of 18 linked essays. I had a style guide for questions of grammar, and the HTML structure of the layouts were rather straightforward. However, I realized rather quickly that if I was going to do this consistently I should put together my own set of guidelines for the actual structure, function and style I would use for approaching this writing project. Nothing about this is formal or official or anything like that. This is just my own personal notes, thoughts and reflections that informed how I approached framing the work.
What follows is the short list of guidelines/rules for composing online exhibition-ish narrative pages for the web which I developed for my own use. Given some recent great discussion of what the ideal for history on the web should be, I figured I would share the rules I set for myself as they might be of use to others working in this form. Ultimately, in the collection objectives section I decided to call it a “hypertext,” which ideally expresses
The Chimera of the Digital Collection Hypertext
An online only interpretive presentation of representations of cultural heritage objects is something of a chimeric creature. It’s the sort of online collection/interpretive material that all kinds of folks develop when they use platforms like Omeka—ticky-tacky interpretive analytical writing and explication alongside a massive pile of related historical primary sources for users to go out and explore on their own.
- Part Exhibition: It’s purpose is similar in purpose to a physical museum exhibit, except that the restraints and benefits of physical space are absent. For example, an online exhibition can sprawl out forever, but you lose out on the quality of “being there” in the presence of “being there with the artifacts.
- Part Illustrated Publication: As text and images on a web page, they are also like those “illustrated history” books, where one works through a linear narrative but can stop off to read detailed information about an image. In this case, the similarity falls off in that hypertext provides a much more networked and connective potential structure for an online text. Furthermore, while people do skim books, web reading is fundamentally different.
- Part Expansive Collection of Sources: Where you only have the space to show an image on part of a page in a book, and there is a limit to what you can display in the physical space of an exhibit on the web you can provide links out to every page in a draft or the whole audio recording.
- All Hypertext: Ultimately, I think the most precise term for what these things are is hypertext. A term that sadly fell out of vogue with cyberspace a while back, but a term I think is worth going back to as HTTP is itself the defining logic and form of the web.
A Ready-to-hand Draft Style Guide
I had some web writing information to work with, but I ended up working up my own style guide-ish set of rules to work from for putting together these pieces. What follows is my rundown of rules (most of which I didn’t break much). As such, the intention of this set of guidelines was to try and take the ideas of exhibition and print publications that make extensive use of deep captions and figure out how they fit into the way the web writing works and people engage with the web. I feel like these served me well, and figured others might be interested in them. I’d similarly be interested in comments/discussion of these.
- Every narrative page stands on it’s own: The web is not a physical space and you have no control over what page someone will see first. The result of this fact is that a well conceived online exhibition narrative page needs to stand on it’s own. That means it needs to have a compelling title that includes key terms in the page, and that the text of a page cannot assume that a reader has read any other text in the exhibition. Every page is effectively the first page/front door for some set of potential users. It’s critical that the page stand on its own and invite users for further exploration at every turn.
- Every caption should explicate/interpret the image/object presented. Images, audio and moving image content needs to be captioned in such a way that the captions explicate and interpret the items. It is not enough to simply say what something is but to scaffold a visitor into seeing what is important about the artifact in this context. Ideally, the way the object is presented/cropped/edited suggests part of this, that is helps to actually show and not just tell. Part of the purpose of presenting these objects is to demonstrate reading and interpreting them. As such, they should not be extraneous. For example, if one want’s to include a portrait of an individual one should not simply say it is a portrait of them. It’s necessary to suggest points in the work to read, like the way they are drawn or items they are holding and how those communicate something about how that individual is being represented in this case.
- Object captions should always stand on their own: The captions for objects presented should also stand on their own. Web readers skim and make use of images as a form of visual headings. As such the captions for those images should make enough sense on their own that visitors can use them as a different index to the content of the page.
- A new heading should break up text after every few paragraphs: Again, Web writing is different from print writing in that web readers are far more likely to skim content. Good and frequent use of headings makes it easy to skim text and further hook readers to dig into the narrative content. Think more Associated Press style and less Chicago Manual of Style.
- An image from an item should always be visible as one scrolls through the page: The goal is showcasing the objects, so there should always be items from the collection visible on the screen at any given moment. This focuses attention on the items while also making the page easier to explore and read. Note: This is a particularly vexing thing to deal with in responsive design for mobile devices. I’d be curious for ideas about how this point should change in a mobile situation.
- Each page should be in the long blog post sweet spot–700-2000 words: This length makes them substantive enough to tell an interesting story and make a few important points but keeps them from being too long that they are difficult to briefly explore. If a piece is getting significantly longer than this it could likely be broken into smaller individual pieces which would have the benefit of creating another page that serves as it’s own point of entry into the exhibition.
- Hyperlink text for connections and emphasis: Each two paragraphs should have at least one hyperlink connecting to an important concept in another section of the exhibit. The links underscore what matters in a given paragraph and make it easy for visitors to chart their own path through the exhibition. This is the primary power of hypertext as a medium. Think of how rich a Wikipedia page entry is with links. The goal of this, and many of these guidelines, is to create a fertile network of connections that can spur the ability for someone to get lost in the content much like people do with Wikipedia. Ideally, item pages will record essays that link to them too, making each item itself into a potential point of entry to the presentation.
- Links should connect consistently connect out across subsections : Each page in the exhibit should ideally include at least one hyperlink to a page in a completely different section. Silos are bad, and history is not a straightforward progression of events. If you think different thematic sections of an exhibition are coherent enough to hang together there should be connections between individual pieces as you go.
- Show parts of items, link out to whole items: Unlike a physical exhibition you are not limited by the size of a frame, showing one page in a book, or putting a video on loop and hoping that people will stick around for it to come back again. Good exhibition narrative pages direct a visitor’s attention to features of items that are particularly interesting in a given context, but ideally that user is just a click away from looking at the whole of a work, or seeing things next to a given letter in a particular folder. There will be cases where this is impossible as either a strain on resources to digitize, or for rights reasons. With that noted, the ideal is to put up as whole a copy of any primary sources that can be integrated in their own right and not to simply crop photos to frame to illustrate the narrative.
What do you think?
Are there things you would add, refine, or take off the list? Do you have any suggestions for other kinds of guidance that is worth integrating with this sort of thing? What thoughts do you have about how this sort of thing would change given different potential audiences? In short, I’m curious to hear what you think of all of this.