A Review of the Königsfelden Online Edition Christopher Pollin Zentrum für Informationsmodellierung (ZIM-ACDH), Austrian Centre for Digital Humanities, Karl-Franzens-Universität Graz Graz, Austria christopher.pollin@uni-graz.at Institut für Dokumentologie und Editorik e.V. March 2023 http://ride.i-d-e.de/issues/issue-16/koenigsfelden 10.18716/ride.a.16.5 https://github.com/i-d-e/ride/raw/master/issues/issue16/koenigsfelden/koenigsfelden.pdf RIDE - A review journal for digital editions and resources Tessa Gengnagel Frederike Neuber Daniela Schulz Ulrike Henny-Krahmer Frederike Neuber Martina Scholger Digital Scholarly Editions http://ride.i-d-e.de/issues/issue-16 10.18716/ride.a.16 Königsfelden Online. Die Urkunden und Akten des Klosters und des Oberamts Königsfelden Department of History of the University of Zurich Editor Halter-Pernet, Colette Editor Hodel, Tobias Editor Teuscher, Simon 2021 https://www.koenigsfelden.uzh.ch 2022-08-07 Criteria for Reviewing Scholarly Digital Editions

born digital

 Documentation Bibliographic description cf. Catalogue 1.2 Is it easily possible to describe the project bibliographically along the schema "responsible editors, publishing/hosting institution, year(s) of publishing"? Yes No Contributors cf. Catalogue 1.4 Are the contributors (editors, institutions, associates) of the project fully documented? Yes No Contacts cf. Catalogue 1.5 Does the project list contact persons? Yes No Selection cf. Catalogue 2.1 Is the selection of materials of the project explicitly documented? Yes No Reasonability of the selection cf. Catalogue 2.1 Is the selection by and large reasonable? Yes No Archiving of data cf. Catalogue 4.16 Does the documentation include information about the long term sustainability of the basic data (archiving of the data)? Yes No Aims cf. Catalogue 3.1 Are the aims and purposes of the project explicitly documented? Yes No Methods cf. Catalogue 3.1 Are the methods employed in the project explicitly documented? Yes No Data model cf. Catalogue 3.7 Does the project document which data model (e.g. TEI) has been used and for what reason? Yes No Help cf. Catalogue 4.15 Does the project offer help texts concerning the use of the project? Yes No Citation cf. Catalogue 4.8 Does the project supply citation guidelines (i.e. how to cite the project or a part of it)? Yes No Completion cf. Catalogue 4.16 Does the editon regard itself as a completed project (i.e. not promise further modifications and additions)? Yes No Institutional curation cf. Catalogue 4.16 Does the project provide information about institutional support for the curation and sustainability of the project? Yes No Contents Previous edition cf. Catalogue 2.2 Has the material been previously edited (in print or digitally)? Yes No Materials used cf. Catalogue 2.2 Does the edition make use of these previous editions? Yes No Not applicable Introduction cf. Catalogue 4.15 Does the project offer an introduction to the subject-matter (the author(s), the work, its history, the theme, etc.) of the project? Yes No Bibliography cf. Catalogue 2.3 Does the project offer a bibliography? Yes No Commentary cf. Catalogue 2.3 Does the project offer a scholarly commentary (e.g. notes on unclear passages, interpretation, etc.)? Yes No Contexts cf. Catalogue 2.3 Does the project include or link to external resources with contextual material? Yes No Images cf. Catalogue 2.3 Does the project offer images of digitised sources? Yes No Image quality cf. Catalogue 4.6 Does the project offer images of an acceptable quality? Yes No Not applicable Transcriptions cf. Catalogue 2.3 Is the text fully transcribed? Yes No Text quality cf. Catalogue 4.6 Does the project offer texts of an acceptable quality (typos, errors, etc.)? Yes No Indices cf. Catalogue 4.5 Does the project feature compilations indices, registers or visualisations that offer alternative ways to access the material? Yes No Types of documents cf. Catalogue 1.3 and 2.1 Which kinds of documents are at the basis of the project? Single manuscript Single work Collection of texts Collected works Papers Archival holding Charters Letters Diary Other Document era cf. Catalogue 1.3 and 2.1 What era(s) do the documents belong to? Classics Medieval Early modern Modern Subject cf. Catalogue 1.3 Which perspective(s) do the editors take towards the edited material? How can the edition be classified in general terms? History Philology / Literary Studies Philosophy / Theology History of Science Musicology Art History Other Spin-Offs cf. Catalogue 4.11 Does the project offer any spin-offs? App Mobile PDF None Other Access modes Browse by cf. Catalogue 4.3 By which categories does the project offer to browse the contents? Authors Works Versions Structure Pages Documents Type of material Images Dates Persons Places Other Keywords Simple search cf. Catalogue 4.4 Does the project offer a simple search? Yes No Advanced search cf. Catalogue 4.4 Does the project offer an advanced search? Yes No Wildcard search cf. Catalogue 4.4 Does the search support the use of wildcards? Yes No Not applicable Index cf. Catalogue 4.4 Does the search offer an index of the searched field? Yes No Not applicable Suggest functionalities cf. Catalogue 4.4 Does the search offer autocompletion or suggest functionalities? Yes No Not applicable Help texts cf. Catalogue 4.4 Does the project offer help texts for the search? Yes No Not applicable Aims and methods Audience cf. Catalogue 3.3 Who is the intended audience of the project? Scholars Interested public Typology cf. Catalogue 3.3 and 5.1 Which type fits best for the reviewed project? Facsimile edition Archive edition Documentary edition Diplomatic edition Genetic edition Work critical edition Text critical edition Enriched edition Database edition Digital library Collection of texts None Other Critical editing cf. Catalogue 3.6 In how far is the text critically edited? Transmission examined Palaeographic annotations Normalization Variants Emendation Commentary notes None Other XML cf. Catalogue 3.7 Is the data encoded in XML? Yes No Standardized data model cf. Catalogue 3.7 Is the project employing a standardized data model (e.g. TEI)? Yes No Types of text cf. Catalogue 3.5. Which kinds or forms of text are presented? Facsimiles Diplomatic transcription Edited text Translations Commentaries Semantic data Technical accessability Persistent identification cf. Catalogue 4.8 Are there persistent identifiers and an addressing system for the edition and/or parts/objects of it and which mechanism is used to that end? DOI ARK URN PURL.ORG Persistent URLs None Other Interfaces cf. Catalogue 4.9 Are there technical interfaces like OAI-PMH, REST etc., which allow the reuse of the data of the project in other contexts? OAI-PMH REST General API None Other Open Access Is the edition Open Access? Yes No Accessability of the basic data cf. Catalogue 4.12 Is the basic data (e.g. the XML) of the project accessible for each part of the edition (e.g. for a page)? Yes No Download cf. Catalogue 4.9 Can the entire raw data of the project be downloaded (as a whole)? Yes No Reuse cf. Catalogue 4.9 Can you use the data with other tools useful for this kind of content? Yes No Declaration of rights cf. Catalogue 4.13 Are the rights to (re)use the content declared? Yes No License cf. Catalogue 4.13 Under what license are the contents released? CC0 CC-BY CC-BY-ND CC-BY-NC CC-BY-SA CC-BY-NC-ND CC-BY-NC-SA PDM No license Multiple licenses Other fair data principles search functionalities data modelling frontend visualization

This review deals with the digital edition “Die Urkunden und Akten des Klosters und des Oberamts Königsfelden 1308–1662“ (Charters and Records of Königsfelden (1308–1662)), which was carried out by the Department of History of the University of Zurich between 2017 and 2020. The edition project provides access to more than 1500 charters and records. The aim of this review is to discuss the project context, the web interface, the data and the quality of the edition. A particular focus will be given to the FAIR data principles. Overall, Königsfelden Online is a successful implementation of a digital edition that provides a coherent collection of structured documents for further research.
Introduction

The digital edition of the charters and records of the Königsfelden Monastery and the Oberamt Königsfelden from the years 1308–1662 (https://www.koenigsfelden.uzh.ch) is the achievement of the Historical Seminar of the University of Zurich and offers insights into a wide range of topics: from social issues of the urban elites and the service nobility to aristocratic history and aspects of economic and women's history. It should be noted at the outset that the edition discussed here deals with a fully annotated corpus of historical sources. The edition created from this material not only provides access to these historical sources and their metadata via collections, but also a full-text search option, indices, a map for locating documents, and experimental visualizations. Moreover, users can access digital facsimiles of the source material, transcriptions, annotated text, including diplomatic annotations such as abbreviations, and annotations of named entities like persons, families, organizations, places, and their historical context. For the annotation of the text, the project used XML and followed the Guidelines of the Text Encoding Initiative P5 (TEI). At the time of the review, the database contained 1557 documents.

This review focuses on the following subjects: The first section provides an overview of the topic, objectives, methods, content, and modelling of the edition. The second section addresses the publication and presentation, including technical aspects, as well as the user interface of the collection, the search options, and the edition views. After a particular focus on the FAIR data principles, the review concludes with a brief discussion of the experimental visualization that the digital edition additionally provides.

Scope of the edition

Under the direction of Prof. Simon Teuscher, University of Zurich, and in collaboration with the State Archives of the Canton of Aargau and the Swiss Legal Sources Foundation, the project was carried out between 2017–2020 as part of the National Fund project Edition der Urkunden und Akten des Klosters Königsfelden (Infrastructure: Editions, 10FE15_157907). In addition to the funding from the Swiss National Science Foundation, the project was supported by a contribution from the Lotteriefonds of the Canton of Aargau. Originally, the project was initiated by Dr. Tobias Hodel, who was in charge until October 2019, as well as Dr. Claudia Moddelmog and Prof. Simon Teuscher. After that, Dr. Colette Halter-Pernet took over the lead until the end of the project. In addition, 10 staff members were involved in the project in various employment relationships and work areas.

Homepage of the digital edition (https://www.koenigsfelden.uzh.ch).
Initial view of the documents. Documents are identified by shelfmark, date, short summaries, and keywords (https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/documents.html).
In the project Königsfelden Online (see fig. 1 & 2), the primary source material that is made accessible are charters. In contrast to the project Monasterium.netMonasterium.net. https://web.archive.org/web/20230125124743/http://monasterium.net:8181/mom/home. , which is an information portal linking various collections, Königsfelden Online is thus an edition project of a single collection. Being a part of Monasterium.net, however, ideas on how to describe charters digitally have been advanced (Vogeler 2010, Vogeler 2018). Here, the Charters Encoding Initiative (CEI) is certainly central, and its considerations have been incorporated into the TEI (TEI P5, ‘Representation of Primary Sources and Winslow 2019).

Selection and Content

Two projects were carried out in advance: The project Königsfelden und sein Adel. Annäherungen an eine neue Sozialgeschichte (SNF Projekt 2012–2016) and the book project Königsfelden. Königsmord, Kloster, Klinik (2010–2012). Both projects were – according to their abstracts and publication lists – essential for the realization of the digital edition. The knowledge gained in the context of these projects forms the basis for the classification of the sources provided with regard to the research questions. Another central preliminary work is the doctoral thesis Schriftordnungen im Wandel. Produktions-, Gebrauchs- und Aufbewahrungspraktiken von klösterlichem Schriftgut in Königsfelden (1300–1600) by Hodel (2020), as it is particularly relevant for the “Dorsualnotizen”Description of the “Dorsualschichten”. https://web.archive.org/web/20230128142753/https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/resources/images/Beschreibung_Do%20rsualschichten.pdf. , which will be dealt with later.

According to the project description, the reviewed project comprises a so-called “Bestandesedition”Possibly translated as “collection edition”; however, the term “archive edition” seems suitable.. It consists of digitized facsimiles as well as transcribed and annotated texts of historical sources from the archive collection Urkunden und Akten des Oberamtes Königsfelden 1314–1797 of the Aargau State Archives.AA/0680 Urkunden und Akten des Oberamtes Königsfelden 1314 -1797, 1314-1797 (Dossier). Web view of the inventory of the archival collection in the Aargau State Archives. https://web.archive.org/web/20230128142602/https://www.ag.ch/staatsarchiv/suche/detail.aspx?ID=201419. These collections are edited according to the provenance principle, i. e. the organization of the documents is based on their origin. The annotations refer to named entities such as persons, organizations and places and at the level of textual structure to the normalization of abbreviations, additions or comments. The collection, which was accumulated over a period of four years, comprises about 1,000 individual sheets and three edited cartularies (“Kopialbücher”).

To enable a quick introduction to the material, the project description outlines those parts of the collection that are relevant to specific research areas. The following research areas are mentioned explicitly: Research on monastic communities, on the history of religious orders, on late medieval economy (e. g. on court and tithe administration), on local housekeeping, on written and oral administrative practices, on institutionalizations and systematization of rights, on gender history, on questions of Reformation history, on church and city history, on architectural history, as well as archaeology and art history, and on the Swiss “nobility” (e. g. on the Habsburg service nobility or on the “bourgeois” elites of the cities).

Documentation

All in all, the edition is well documented. The detailed project description includes the project context, the scope of the material, and editorial guidelines. A detailed documentation of the technical implementation and the workflows for the collecting of the data is, however, missing. On the ZenodoZenodo is an online storage service used for scientific datasets, among other things, and it is common practice to back up data there. https://web.archive.org/web/20230128143830/https://zenodo.org/. Halter-Pernet, Colette, Teuscher, Simon, Hodel, Tobias, Barwitzki, Lukas, Egloff, Salome, Henggeler, Fabian, Nadig, Michael, Steinmann, Anina, Stettler, Sabine, & Prada Ziegler, Ismail. (2021). Charters and Records of Königsfelden Abbey and Bailiwick (1308–1662) (1.0) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.5179361. page related to the project, the scope of the digital data is specified, but the workflows of the data acquisition or the modelling decisions are not documented.

Mission

Since the edition calls itself a “Bestandesedition”, its primary intention is to serve as an information system providing access to historical sources. As far as this purpose is concerned, the edition keeps its promise. The three main objectives of the edition are: To provide the scientific community with a comprehensive corpus of historical sources, taking into account digital methods for further processing of the data. The preparation and annotation of the so-called “Dorsualnotizen”, which are located on the back of the original documents. These notes, consisting of signatures, date, notations or brief remarks, allow tracing the origin, purpose, location, and organization of the documents. This type of information offers new insights into the study of medieval and early modern written and administrative culture (cf. for more details: Hodel 2020, 109–170). A contribution to the development and implementation of digital editions in general. As elaborated in the following, these defined objectives are clearly achieved by the edition.

Method and Representation of documents and texts

As far as categories of information are concerned, the edition focuses on “Regesten” (short summaries), named entities, the description of the material as well as editorial annotation for a better understanding of the content, such as additions, loss, or deletion of text. This edition is thus document-focused. The aim of the edition is to make the documents findable and to serve as a working basis for further – but not exclusively historical – research.

The backside of a facsimile of the text-image synopsis showing the “Dorsualnotizen” (https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/docs/U-17_0001.xml).
The digital facsimiles are of high quality and displayed using the IIIFInternational Image Interoperability Framework. https://web.archive.org/web/20230128144020/https://iiif.io/. viewer OpenSeadragon.An open-source, web-based viewer for high-resolution zoomable images, implemented in pure JavaScript, for desktop and mobile. https://web.archive.org/web/20230128144119/https://openseadragon.github.io/. It is possible to zoom into the scans to analyse details in writing and seals. For charters, the front and back sides are shown. The backside is also transcribed and annotated, as they contain the earlier mentioned “Dorsualnotizen” (see fig. 3). On the back, however, it is not so easy to quickly match the transcription and the position of the text in the facsimile. A highlight function for the text, especially the notes on the back, would allow an optimized synoptic view since the notes are very scattered and can be found in different positions.

Modelling

There is a detailed description of transcription guidelines and annotation practices. For the transcriptionTranskriptionsregeln deutschsprachiger Texte der Sammlung Schweizerischer Rechtsquellen (SSRQ), https://web.archive.org/web/20230128144244/https://www.ssrq-sds-fds.ch/wiki/Transkriptionsrichtlinien. as well as for the datingDatierungsrichtlinien, https://web.archive.org/web/20230128144353/https://www.ssrq-sds-fds.ch/wiki/Datierungsrichtlinien. the edition project applies the guidelines of the Swiss Legal Source Foundation (SSRQ). For both areas of application, the project offers a recommendation (but not a TEI customization) with regards to the implementation in TEI. Deviations from SSRQ and the specific features for “Dorsualnotizen” are noted separately.Transkriptionsrichtlinien und Auszeichnungspraxis, Editionsprojekt Königsfelden, https://web.archive.org/web/20230128144553/https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/resources/images/TRL_Web.pdf. Thus, primarily, the edition is based on the TEI Guidelines. The basic structure of the TEI documents in the edition consists of the facsimile and its zones to express regions on the digital facsimiles and the annotated text areas. The textual body is represented using <p> and <lb> elements. The <msDesc> element, moreover, contains the most important metadata.

Snapshot of a TEI file after downloading it from Zenodo. (AA_0428_0002.xml from https://zenodo.org/record/5179361, accessed 20.12.2022).
Whereas the TEI documents (see fig. 4) are well-formed to allow further processing and to ensure their reusability, a more detailed exploration of the edition revealed that the documents are not valid according to the TEI. Unfortunately, the project does not provide any indications in the metadata of the XML/TEI files, nor a TEI customization, ODD or schema that could be referenced to the TEI documents of the edition to ensure their consistency.

After examining three TEI documentsThe files examined were AA_0428_0002.xml, AA_0428_0138.xml and U-17_0009.xml from https://zenodo.org/record/5179361, accessed on the 07.08.2022., the following minor errors that lead to invalid TEI documents have been identified. Many of these problems seem to be due to sloppy implementation but are mostly minor bugs. Empty attributes @ref (ref=""). Invalid <publicationStmt> and <editorialDecl>. Moreover, the <publicationStmt> element seems to lack information. Empty elements like <taxonomy>, <listPerson>, <listOrg>, or <listPlace>. Invalid use of the attributes @width and @height as the unit of measurement, like “cm”, is missing to match the regular expression. Improper usage of the attribute @type (type="marginal") in <p> elements. Invalid usage of the attribute @agent in <damage agent="faded ink">, as attribute values do not allow spaces. Also, the element <comment> is used incorrectly.

In addition to these non-TEI compliant implementations, the following decision concerning the text model are worth discussing as well: Annotating the “Dorsualnotizen” is essential for the project. It seems to me, however, that the usage of the attribute @rend does not fit. It is used like: <p facs="#facs_2_region_1533022656524_73" rend="dorsual_22_sigle">. The TEI guidelines define @rend as follows: “indicates how the element in question was rendered or represented in the source text”.att.global.rendition. P5: Guidelines for Electronic Text Encoding and Interchange. Version 4.4.0. https://web.archive.org/web/20230128145106/https://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-att.global.rendition.html, accessed on the 07.08.2022. So, in my opinion, the attribute @rend should be used to express the representation of the text, like italic, bold, or dotted. ‘Knowing’ that the text on the back of a document is a “Dorsualnotiz” according to a certain categorization, as it is used for the search functionality, is not covered within the scope of @rend. Therefore, the attribute @ana would be a better fit.

Documents within Monasterium.org may represent an alternative or comparable use of XML/TEI for annotating these types of documents (cf. Roland 2020). The given example does not contain an annotated text, but rich metadata about the document, which are especially important to implement a front end with different search functions.

Publication and presentation
Technical infrastructure

Since the technical implementation is poorly documented, it is not clear whether the mention of eXistSolutions GmbH refers only to the usage of eXist-dbeXist-db is an open source NoSQL and native XML database built on XML technology. https://web.archive.org/web/20230128145923/http://exist-db.org/exist/apps/homepage/index.html. , or if they also carried out the implementation. The hosting and maintenance of the eXist database is not further specified. The long-term archiving of the data is – reasonably – handled by Zenodo.

Browse, Search and Index

Searching and browsing are essential functionalities of a platform on which sources are to be found for research purposes. And they also play an important role in the edition. Therefore, the Königsfelden online edition offers four points of access: Collections, Search, Index and Map.

Collection view in the footer of the homepage, which gives an overview of the entire collection.
The Collection view (see fig. 5) can be accessed in two ways. Via “Documents” in the navigation or as one of the areas on central views, which is located above the footer. In the latter, the separation into the three main categories “Chronologische Aufteilung”, “Dorsualschichten” and “Häufigste Schlagwörter” gives an overview of the content and scope of the categories. From the generated hit list, users can get to the detailed view of a single document.

Full text search for “Wein*” using truncation (*) with further constraints and its search results (https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/search.html?refresh=true&query=Wein*&subtype=edition&filter-period-min=1350&filter-period-max=&filter-language=Fr%C3%BChneuhochdeutsch&filter-material=Pergament&doc=).
The Search view is another entry point and allows full-text searches and advanced search queries. The query can be restricted to edition text or to metadata, and it is possible to further refine the search in terms of time, language, and medium. Detailed information on how to use the search (truncation, Boolean operators, wildcards, etc.) can be easily accessed. Searching for “Wein*” in the edition text with additional settings, for example, returns a transparent and explicable result (see fig. 6). It is clear why a document was found, as the query text is highlighted in its context. Thus, the online edition provides a comprehensible and straightforward search that offers enhanced settings without overwhelming the user.

Index search for the keyword “Wirtshaus” (https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/detail.html?ref=key000064).
The index view (see fig. 7) is used to search for documents that are directly linked to named entities like people, organizations, places or keywords. In this regard, it should be mentioned that the display of the results list in the index search differs from the other search views, as it is the detailed view of an index term. For example, the “Regest” is missing, which could be a critical information for certain users. Instead, it is similar to the tabular-like index results view, which is used to represent prosopographic data of annotated persons.

Documents displayed applying the map view. Click to list all documents linked to this location on the right side of the map (https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/map2.html).
The last main point of access to the documents is the map view (see fig. 8), from which all documents can be selected on a map in order to get to the edition view. There are no further filter options available. Only the frequency of mentions of an annotated place is highlighted. The relation of the place to the document is not visible, just whether the place was annotated or not. The handling of the map view could certainly be improved with little effort since there are many JavaScript libraries for this use case. Especially, regarding the fact that nowadays users are accustomed to well-functioning interfaces and smooth handling due to applications like Google Maps.

Interface and Usability

The web front end is implemented using Bootstrap 3 and jQuery. Responsiveness of the webpage is given. Functionalities like the facsimile viewer are hidden in the mobile view, which represents a pragmatic solution.

A major drawback of the website are the loading times. The loading of certain pages and search queries takes quite a long time. For example, when clicking on the “Documents” button in the navigation to view all documents, it takes about 15 seconds for the page to load. Even if you click on the pagination, you will encounter slow processing, because it loads all the 60 documents until the next action can be performed. The same loading issue arises with search queries, although an online edition, being a special type of web resource, should allow users multiple query functions to search for specific documents or explore the collection. The loading time might severely lower the users’ motivation and might edge the threshold of the users’ patience.

Detailed view of a document with the “standardized” selected view showing the normalized text. All annotations are coloured (https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/docs/U-17_0102.xml?odd=ssrq-norm.odd).
The detailed view of a document (see fig. 9) is divided into a section containing data and text, as well as a section with the digital facsimiles in an embedded OpenSeadragon Viewer, which represents a classic image-text synopsis. Furthermore, it consists of a “Register”, basic metadata about the document and its materiality, its language or format, and the transcribed text of the edition. Via a checkbox the text can be read as standardized or non-standardized text. The categorization of annotated entities such as places, persons or organizations is explained by an overview and a coloured legend. Here you can also find further contextual information, like life data or hyperlinks to the detailed view of a named entity, such as a person. Annotations such as additions or deletions are resolved via tooltips. At this point it should be noted that some tooltips are not immediately recognizable. For example, there is a tooltip on the textual sequence “disen brief ansehent” that contains additional information on the original spelling “b’ef” for the standardized word form “brief”. The lack of any apparent indication of a tooltip, therefore, not only deprives the user of interesting additional information, but also constitutes a limitation in terms of usability.

Accessibility is a distinct field of web development that also deals with barrier-free access to web content. In order to optimize the accessibility of a website, the web content needs to provide valid data, for example in terms of HTML5 validity, which in turn has an impact on whether your web content will be discovered by search engines. The accessibility of web pages can be tested manually or by using tools, such as the WAVE Web Accessibility Evaluation Tool https://wave.webaim.org. or the W3C HTML5 Validator https://validator.w3.org..

When validating the web page of the Königsfelden edition with WAVE, minor errors in the HTML code become visible. It shows that the @alt and @label attributes are missing, and that there is more than one <main> section. Especially @alt and @label are important attributes if a page is to be read by a screen reader. These are minor errors that do not impede the functionality but still limit accessibility and do not represent good practice. Usually, the funding agency and/or the institution hosting the website has/have their own specifications that have to be considered. For more details on the accessibility of web pages, I can highly recommend the blog post by Stanley (2018).

When exploring the edition, another restriction must be taken into consideration: The entire digital edition is only available in German. Since the majority of the sources is in German, the user interface is also adapted to German speakers, which is legitimate by all means. Nevertheless, an abstract in English could possibly open up access to other groups as well.

FAIR

The FAIRFAIR principles. GO FAIR. https://web.archive.org/web/20230128150113/https://www.go-fair.org/fair-principles/. data principles create a reference framework that improves the findability, accessibility, interoperability, and reusability of data (Wilkinson 2016). In its origin, it refers primarily to the data itself, but in this context, it also covers the edition as a whole. In the case of this review, it concerns the XML/TEI files, which are stored separately from the edition on Zenodo. The following aspects are discussed in detail with respect to the FAIR criteria.

Findability

By findable we mean whether a data set can be easily found by both humans and machines. It includes four sub-goals. The first refers to assigning globally unique and persistent identifiers to the data. Each document has a citation suggestion that looks like this: “Digitale Edition Königsfelden, URL: <www.koenigsfelden.uzh.ch/exist/apps/ssrq/docs/U-17_0001.xml>, Stand: 7.8.2022.” It contains a URL that uniquely identifies each document. However, it cannot be concluded whether the URL is a persistent identifier. Instead, it shows that eXist-db is addressed directly. On Zenodo, there is a DOI that refers to the entire data dump: 10.5281/zenodo.5179361.

Secondly, sufficient metadata, that allows contextualizing the documents, can be found on the Zenodo webpage and also on the edition webpage. For each individual TEI document, this is only partially the case. In the TEIs one can only find metadata about the actors involved, the title of the edition, the publication date, descriptive metadata of the document contained by <msDesc>, and the transcription and annotation guidelines. Other necessary metadata about the individual object, rights or publication can only be found on the Zenodo webpage. The criteria are thus satisfied to a limited extent. Furthermore, there is no identifier or URL that establishes a link between the individual document and the edition. This is only possible via the signature, such as “StAAG U.17/0887b”. The shelfmark is used as ID, as indicated in the URL of the web representation of the documentStAAG U.17/0887b. https://web.archive.org/web/20230128150317/https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/docs/U-17_0887b.xml?odd=ssrq-norm.odd. , where, in terms of URL consistency, characters have to be replaced. Using “0887b”, one can find the object on the page via the “Open Document” function. Overall, from my point of view, in this regard the edition is not complying with the FAIR data principle, that requires metadata to clearly and explicitly include the identifier of the data they describe. Whereas the edition can be found effortlessly via search engines such as Google, Yahoo or Bing, it is not listed in the Marbacher EditionendatenbankRoland S. Kamzelak and Lydia Michel, Marbacher Editionendatenbank. https://web.archive.org/web/20230128150534/https://www.dla-marbach.de/digital-humanities/editionen-db. nor in Franzini’sGreta Franzini, Catalogue of Digital Editions. https://web.archive.org/web/20230128150700/https://dig-ed-cat.acdh.oeaw.ac.at/. catalogue, nor is it findable via scientific search engines like Google Scholar or Semantic Scholar. During the peer review of this review, the edition has been listed in Sahle’sPatrick Sahle, Scholarly Digital Editions. An annotated List. https://web.archive.org/web/20230128150844/https://www.digitale-edition.de/exist/apps/editions-browser/index.html. catalogue in 2022. All in all, however, the findability of the edition is given.

Accessibility

If an edition is freely accessible for any user without access restrictions (including authentication and authorization), then it is accessible in the sense of the FAIR criteria. The website can be accessed via HTTP without further authentication or authorization. The access to metadata, even when the website is no longer available, however, is only partially guaranteed. As mentioned before, some portions of metadata can be found on Zenodo, some on the edition webpage and a big part, but not all metadata in the TEI documents of this edition. Now, since the TEIs do not include all the existing metadata, changes on the edition webpage or Zenodo would affect the accessibility of a large part of the metadata.

Interoperability

Generally, data is used together with other data in applications or workflows for analysis, storage, and processing. Therefore, it is necessary that data, with as little effort as possible, can be merged, integrated, or combined. Consequently, data should use a formal, accessible, shared, and broadly applicable language for knowledge representation. The TEI is the (de facto) standard that is used for the realization of editions of historical sources. It should be noted, however, that adaptations are necessarily domain specific. This means that historical documents, such as charters, require their own modelling. Next to the XML/TEI files all other primary data of the project can be found and cited on Zenodo (Halter-Pernet, Colette et. al 2021). This data dump consists of PageXML (~30.0 MB), which is the output of TranskribusTranskribus is a platform for the text recognition, image analysis and structure recognition of historical documents. https://web.archive.org/web/20230127071754/https://readcoop.eu/de/transkribus/. , XML/TEI files (19.0 MB) specified by Swiss legal sources, and digital facsimiles (21.0 GB).

Reuse

The goal of the fourth FAIR data principle is to maximize the reuse of data. For this purpose, data should be well described in order to be used in various contexts. The platform is licensed with CC BY-NC-SA and the edition data with CC BY 4.0. Data and metadata are therefore released with an explicit and accessible data usage license. However, this information should also be included in the <teiHeader> of the TEI documents. Data are associated with detailed information on provenance like project title, persons involved, and editing guidelines. These details can be found in the XML/TEI, and some further information on provenance are available in the project description on the edition and on the Zenodo page. Thus, with the selection of the XML/TEI format, the data meets a domain-relevant community standard.

Even though it is not explicitly defined in the FAIR criteria, data exports and API are crucial for digital editions. No technical interfaces, spin-offs or export formats could be identified, neither does it seem to be possible to directly address the XML/TEI of a source document in the web front end. Nevertheless, the FAIR data principles are met.

Experimental visualization

The “Überlieferung” button leads the user to an experimental overview, where the collection is presented by means of information visualization. This view incorporates four sections: 1) the visualization of the creation of documents, their copies and their “Dorsualnotizen”, 2) the frequency and occurrence of “Dorsualnotizschichten”, 3) the network visualization of the “Dorsualschichten”, and 4) a section on archival orders. It is a very good idea to provide such a view, as it allows exploratory access to the dataset, in addition to the already existing ones. The first three sections will be briefly discussed in the following. Before doing so, though, I want to emphasize that I am well aware that it is a complex challenge to create interactive visualizations from a dataset of historical information. Especially, if you do not only wish to produce beautiful images, but to also create added value in terms of gaining knowledge via the visualization, and in particular, if you are providing it as an interactive web application.

Visualization of the production of charters, their copies and their “Dorsualnotizen”

Visualization that illustrates the production of documents as well as the copying activity (https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/stemma.html#visualisierung).
This visualization illustrates the production of documents as well as the copying activity (see fig. 10). The Y-axis represents the time (1300–1789) and the X-axis represents the individual pages of the cartularies. Each blue dot symbolizes a single document located at the correct height of the Y-axis depending on the date of origin. The X-axis shows the date of origin within the year (January–December). The horizontally arranged dots in different shades of yellow indicate copies of documents in the three processed cartularies. Each document is also connected to its copies by lines. Based on the position of the yellow dot above the X-axis, it is possible to find out on which folio page in the corresponding cartulary users can find the copy. Clicking on the dot opens the corresponding document in a new window.

The idea behind the visualization is very interesting. It provides an overview of the temporal relationship between the cartularies and documents. However, there seem to be some issues as far as the implementation is concerned. The orange highlighting creates a messy ball of information, and it is quite difficult to select another related element. Clicking on one of the buttons under “Dorsualnotizen” on the right, such as “dors_2”, does not lead to any result. In my opinion, it would be advisable to implement the Mantra of Information Seeking (Shneiderman 1996, 336–343), namely, to filter the information space according to certain criteria, like the “dorsal layers“ and then jump into the details – the document itself.

Frequency and occurrence of “Dorsualnotizschichten“

Diagram that shows the respective temporal scope of the individual “Dorsualnotizschichten” (https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/stemma.html#Dorsualnotizschichtenzeitlinienvisualisierung).
The diagram shows the respective temporal scope of the individual “Dorsualnotizschichten” and thus enables a visual comparison of the target documents (see fig. 11). The designations of the “Dorsualschichten” are linked to the documents of the edition. This is a successful visualization, in my opinion. At a glance, you can see the number of “Dorsualschichten” and in which period they occur. The additional heat-map-like layer shows the occurrence of the phenomena per year in colour. The existing legend provides an easy way to understand the visualization and colour coding. A click on the labels of the “Dorsualschichten” should give a search result of all corresponding documents, but, unfortunately, it only leads to an error message. It would be a great additional feature to get another layer of information showing time-related details about the documents, and thus providing an immediately visible temporal classification of the documents without a search query. This could be solved, for example, with a hover function over each bar representing a single year. Alternatively, common filter functions could help to bring more interactivity into the visualization.

Network visualization of the “Dorsualschichten“

Network visualization of the Königsfelden edition (https://www.koenigsfelden.uzh.ch/exist/apps/ssrq/stemma.html#Dorsualnotizschichtenzeitlinienvisualisierung).
The network visualization of the Königsfelden edition (see fig. 12) shows the connection between a document and one or more “Dorsualschichten”. Each of them is represented by a different colour and can be switched on or off. By clicking on a document node, only the associated “Dorsualschichten” are displayed. Clicking on the name of a document node, opens the corresponding document.

The idea is attractive, but again, there are some implementation issues. If you click on a label like “number”, it results in displaying a blank page. The colour key for the individual nodes is quite small and therefore difficult to identify. Also, the readability of the tooltips containing some relevant information is definitely improvable. In addition, the colours are too similar. For example, the shades of pink are not distinguishable when working with the visualization. The information space is limited to a certain selection size, which makes the visualization very confusing. However, with only a small selection of documents, it is possible to get useful visualizations.

Conclusion

The digital edition of Die Urkunden und Akten des Klosters und des Oberamts Königsfelden 1308–1662 keeps its promise to be a comprehensive, coherent collection of edited, historical documents of more than 1500 charters and records, that can be used for specific historical research. It includes digital facsimiles, metadata on materiality, annotated texts focused on the content of the sources, search options and indices. Reusability and long-term availability of the research data (XML/TEI) is enabled through a data dump on Zenodo.

All in all, this is a successful implementation of a digital edition, even if minor flaws remain. However, these shortcomings do not really limit the use of the resource as they relate to invalid HTML5 and TEI, accessibility, user interface issues, as well as not entirely perfect but very interesting visualizations. Nor do these minor insufficiencies diminish the achievement of compiling and providing (almost) FAIR-compliant research data. The only real issue I notice is the loading time of certain web pages and search queries. From my experience, I dare to say that with maybe 2-3 months more project time, these minor issues and maybe also the loading time troubles could have been fixed.

Halter-Pernet, Colette, Teuscher, Simon, Hodel, Tobias, Barwitzki, Lukas, Egloff, Salome, Henggeler, Fabian, Nadig, Michael, Steinmann, Anina, Stettler, Sabine, & Prada Ziegler, Ismail. 2021. Charters and Records of Königsfelden Abbey and Bailiwick (1308–1662) (1.0) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.5179361. Hodel, Tobias. 2017. Königsfelden Abbey and Its First Cartulary: Dealing with Charters in the Fourteenth Century. In: Barret, Sébastien; Stutzmann, Dominique; Vogeler, Georg (Hg.) Ruling the script in the Middle Ages: formal aspects of written communication (books, charters, and inscriptions). Utrecht Studies in Medieval Literacy: Vol. 35 (S. 331–355). Turnhout: Brepols Publishers 10.1484/M.USML-EB.5.112441. Hodel, Tobias. 2020. Schriftordnungen im Wandel. Produktions-, Gebrauchs- und Aufbewahrungspraktiken von klösterlichem Schriftgut in Königsfelden (1300–1600). Spätmittelalterstudien: Vol. 7. Konstanz: UVK Verlagsgesellschaft 10.2357/9783739880600. Roland, Martin: Illuminierte Urkunden 1430-12-06_St-Gallen, In: Urkunden als offene Forschungsdaten. Langzeitarchivierung von Monasterium.net in GAMS, Graz 04.12.2020. https://web.archive.org/web/20230128145506/http://gams.uni-graz.at/o:cord.16312845.0c4e.36ad.ab54.5ebdb45e8513/TEI_SOURCE. Shneiderman, Ben. 1996. The Eyes Have It: A Task by Data Type Taxonomy for Information Visualizations. In: Proceedings of the IEEE Symposium on Visual Languages, Washington, 336–343. Stanley, Pablo. 2018. Designing for accessibility is not that hard. Inside Design Blog. https://web.archive.org/web/20230127071513/https://uxdesign.cc/designing-for-accessibility-is-not-that-hard-c04cc4779d94?gi=3816a0a5a7ad. Teuscher, Simon, Claudia Moddelmog. (2012). Einleitung in: Königsfelden: Königsmord, Kloster und Klinik. hier+ jetzt. Text Encoding Initiative, P5: Guidelines for Electronic Text Encoding and Interchange section ‘Representation of Primary Sources’, https://web.archive.org/web/20230127071329/https://www.tei-c.org/release/doc/tei-p5-doc/en/html/PH.html, accessed on the 10.08.2022. Vogeler, Georg. 2010 “Charters Encoding Initiative Overview,“ Digital Proceedings of the Lawrence J. Schoenberg Symposium on Manuscript Studies in the Digital Age: Vol. 2: Iss. 1, Article 8. https://web.archive.org/web/20230127071230/https://repository.upenn.edu/ljsproceedings/vol2/iss1/8/. Vogeler, Georg. 2018. Digital Diplomatics: The Evolution of a European Tradition or a Generic Concept? In: Cubelic, Simon, Michaels, Axel und Zotter, Astrid (eds.): Studies in Historical Documents from Nepal and India, Heidelberg: Heidelberg University Publishing, 2018. 85–109. 10.17885/heiup.331.454. Wilkinson, M., Dumontier M., Aalbersberg I. et al. (2016). “The FAIR Guiding Principles for scientific data management and stewardship”. Scientific Data 3, 160018. https://doi.org/10.1038/sdata.2016.18. Winslow, Sean M. 2019. Modelling charters in TEI P5: the TEI_CEI ODD. In: TEI 2019 Book of Abstracts. https://web.archive.org/web/20230127071110/https://gams.uni-graz.at/o:tei2019.132.