Browsed by
Tag: schema

A New(ish) Approach to Markup in the Undergraduate Classroom

A New(ish) Approach to Markup in the Undergraduate Classroom

By Kevin G. Smith, Ph.D. Candidate in English, Northeastern University

Note: Kevin G. Smith is a pedagogical development consultant for the WWP. His dissertation research is partially supported by a grant from the NULab for Texts, Maps, and Networks.

A few summers ago, I spent my days working in Northeastern’s Digital Scholarship Commons. As is common in that space, there were nearly daily meetings of different teams of faculty, library personnel, and graduate students working on digital projects. One of these projects was The Early Caribbean Digital Archive (ECDA). During that summer the ECDA project team was working on customizing a TEI schema to encode their texts in ways that were more in line with their decolonial archival goals. As I procrastinated on my own work, I was overhearing these amazing conversations that the EDCA team was having about the meanings and applications of certain aspects of their TEI customization. How should they tag an embedded or mediated slave narrative, for example? What to do about unnamed slaves? And how might they handle commodities? What are the ethical ramifications of encoding a slave as a commodity (or not)?

As I sat, listening to these conversations, I began to realize that it was precisely because they were encoding the texts in TEI that these conversations were happening. The act of encoding literally inscribes texts with interpretation, forcing the project team to discuss just what kinds of interpretive judgments they wanted to make. And they were important conversations: about how we represent our objects of inquiry in the humanities, about the ethics of data representation. (By no means am I the first to realize this. For a compelling example, see Julia Flanders: “The Productive Unease of 21st-century Digital Scholarship.”)

The point is that I was struck by these conversations. And I began to think about how the tension of formalization, this “productive unease,” as Flanders terms it, might be leveraged in writing classrooms. Could I somehow use the TEI to intervene in students’ writing processes, to foster these kinds of conversations about their own writing? What would that even look like?

Two years later, in the summer of 2016, I taught my first markup-based writing course at Northeastern. In the intervening years my approach shifted from using the TEI to designing a built-from-scratch XML schema for each course. Thus far, I’ve taught two courses using this method (Advanced Writing for the Technical Professions in the summer of 2016 and First-year Writing in the fall of 2016). In addition to writing their assignments in XML (using Oxygen), students in these courses engage in a semester-long, collaborative writing project: the design and implementation of an XML schema that structurally and rhetorically models a range of genres of writing.

This approach—using XML to produce texts—represents a shift from the mimetic roots of XML and its primary use in humanities research, the TEI. In the rest of this post, I want to briefly discuss this shift and its implications for the study of markup.

Teaching with Markup

 There are many wonderful examples of using the TEI and XML in classrooms. Kate Singer’s use of TEI for developing poetic vocabularies in an undergraduate class comes to mind, as does Trey Conatser’s use of XML in a first-year writing course at the Ohio State. Though, at first blush, these two markup classrooms may appear very different—one being in an upper-level literature course and the other a first-year writing course—the perceived pedagogical benefits of using markup are similar. Both pedagogues seek to foster close attention to the object of study—a poem or the student’s own writing—through what is essentially a process of annotation.

Where my approach to markup differs from these (and most traditional) classroom uses is in the thoroughly bottom-up, data driven approach to schema design (Piez, 2001). Students begin with a (basically) bare schema and—iteratively and deliberately over the course of an entire semester—design and revise the schema for a range of writing tasks using document analysis and modeling, qualitative writing research methods, and their own experiences of authorship. The result is a shift from annotation to production, from product to process.

An example may be illuminative here. A group of students decide they would like to design a schema for movie reviews. They begin the process by researching the genre—gathering examples, examining related genres, tracing the circulation and uptake of the genre, interviewing experienced writers and readers of the genre, and so on. Based on this research, the group identifies the salient structural, rhetorical, and content-based components of the genre—a movie review includes a series of paragraphs, for example; the first of these paragraphs must, according to the students, include a component called “opinion,” which has a specific definition and different types. They name these components and write a prose pseudo-schema, including documentation, attributes, dependencies, and rules for the components. The pseudo-schema is translated into an XML schema using Relax NG (by me).

An element list from an in-class schema design session with students in the First-year Writing course of 2016.

Once the schema is drafted, each student writes an individual XML document, their own example of a movie review that responds to a unique rhetorical situation. Based on this experience, the group reconvenes to revise their schema. They might, for example, decide that the <opinion> element should be optional in the first paragraph, or decide that an additional attribute value should be added to the @type attribute, or choose to adjust the definition of the element itself. Once schema revision is complete, students revise their XML documents. And on it goes.

An example of XML markup designed for the course.

What I hope the above example illuminates is the thoroughly process-oriented approach to markup adopted in these classes. The schema is not static. It is a living document that affects and is affected by student’s experiences of composing, among other things. Neither are the student-authored XML documents static. They are repeatedly invalidated by revisions to the schema. They are subject to feedback from classmates and instructor. They must be continually revised. From a digital humanities perspective, this application of markup may seem alien. In fact, in some ways, it doesn’t even matter what the schema ends up looking like (though it can be fascinating). The object of using markup in this way is not to produce the perfect model of a genre. In fact, an understanding of genres as social actions, rather than a set of ossified textual features is central to the theoretical framework of the course. This understanding resists the idea that genres can be accurately modeled. The point of using markup is to foster productive conversations about writing, to interrupt the normal thinking and writing processes of students in productive ways. This brings us back to the conversations I overheard in the summer of 2014, eavesdropping on the ECDA when I was supposed to be writing.

An example of a markup output document for display. The XML is transformed to HTML with custom XSLT and highlighted according to XML tags.

But this approach raises new questions. How do I know if this approach is productive in the ways that I hope? What kinds of conversations are students having in these classes? How does markup function rhetorically for students when used for authorship? Does writing in XML and designing schemas for authoring contribute to students’ understanding of their writing and reading processes? Do reading and writing practices in the markup classroom transfer to other contexts? These questions just so happen to be the basis for my dissertation research, which takes as its objects of inquiry the two markup-based writing courses.

Studying (Authorial) Markup

The questions posed above present unique methodological concerns for the study of markup. A shift from product to process raises practical questions concerning how we access students’ experience using markup in this way. How can I make claims about the rhetorical and expressive capacities of authorial markup? How can I understand the role of the schema, the markup, and the platform(s) in students’ writing, reading, and thinking processes? In short, how do I study this?

Here, a slight shifting in thinking—from the digital humanities to writing studies—is helpful. While the pedagogical approach may be unconventional, my research questions are typical of writing studies research. Methods for studying student writing and experience in classroom settings are well established in the field. Although qualitative approaches to the study of markup are not typical in the digital humanities, the research questions for this project, based, as they are, on student experience, reflection, writing, and perception, necessitate the adaptation of innovative methods. To this end, I’ve employed a teacher research methodology—a systematic approach to data collection that honors the inside perspectives of teachers and students—that adapts qualitative research methods culled from ethnography, education, and writing studies research. Data for the study was gathered from direct participant observation, reflective journaling, semi-structured and directed qualitative interviews (three interviews each with nine case study students), and the collection of student writing (normal prose and XML, including version control logs for all XML files).

At this point, data collection has ended and the project is shifting to the data analysis phase. It is too soon to report results, however, early indications from student interviews point to some promising findings around student reflection and transfer, the multi-directional mediation of the schema, and students’ use of markup as a tool for generic invention and change. Here, it may be enough to assert that qualitative approaches to studying markup-based undergraduate courses may be fruitful. Indeed, digital humanities courses in general may benefit from adopting qualitative methodologies, like teacher research, to self-assess and to advocate for curricular change and institutional support.

The assignment discussed above is collected with the pilot set of teaching materials from the WWP’s pedagogical development consultants and is available here.

Registration is Now Open for Two WWP Workshops

Registration is Now Open for Two WWP Workshops

Registration is open for two upcoming TEI seminars offered by the Women Writers Project and the Digital Scholarship Group at the Northeastern University Library. The first workshop, Introduction to TEI, will be held on February 17th–18th. The second workshop, TEI Customization, will be held on April 7th–8th. Northeastern University will host both of the seminars. The cost for each is $450 (students and TEI members, $300). Registration is free for members of the Northeastern University community. For more information and to register, please visit our workshops and seminars page.

Introduction to TEI offers an intensive exploration of scholarly text encoding, aimed at an audience of humanities scholars, archivists, and digital humanists. Through a combination of hands-on practice, presentation, and discussion, participants will work through the essentials of TEI markup and consider how markup languages make meaning and support scholarship in the digital age. No prior experience is necessary. Topics covered include:

  • Text markup languages as an instrument of humanities scholarship
  • Basics of TEI markup: essential text structures and genres
  • Advanced TEI markup: editorial markup and commentary, details of physical documents, complex structures
  • Contextual information and metadata

The schedule for this workshop is available hereRegister here by February 10, 2017.

The TEI Customization seminar will introduce participants to the central concepts of TEI customization and to the language (a variant of the TEI itself) in which TEI customizations are written. When properly planned, the TEI customization process can make a huge difference to the efficiency of a TEI project and the quality and longevity of its data. Good customizations capture the project’s specific modeling decisions, and ensure consistency in the data, while retaining as much interoperability and mutual intelligibility with other TEI projects and tools as possible. Customization also contributes importantly to the process of data curation, both at the time of data creation and later in the project’s life cycle. Topics covered include:

  • Background on how the TEI schema is organized
  • Essentials of the TEI’s customization language
  • Using Roma to generate schemas and documentation
  • Designing a schema for your project: data constraint, work flow, and long-term maintenance
  • Conformance and interoperability

The schedule for this workshop is available hereRegister here by April 1, 2017.

We hope to see you there!