Documentation and the users of Digital Resources in the Humanities
Abstract
PurposeThis article discusses the importance of documentation for digital humanities resources. This includes technical documentation of textual markup or database construction, and procedural documentation about resource construction.
MethodologyWe present a case study of an attempt to re-use electronic text to create a digital library for humanities users, as part of the UCIS project. We discuss the results of qualitative research by the LAIRAH study on provision of procedural documentation, and user perception of the purpose, construction and usability of resources collected using semi-structured interviews and user workshops.
FindingsIn the absence of technical documentation, it was impossible to reuse text files with inconsistent markup (COCOA and XML) in a Digital Library. Also, although users require procedural documentation, about the status and completeness of sources, and selection methods, this is often difficult to locate.
Practical implicationsCreators of digital humanities resources should provide both technical and procedural documentation and make it easy to find, ideally from the project website. To ensure that documentation is provided, research councils could make documentation a project deliverable. This will be even more vital once the AHDS is no longer funded to help ensure good practice in digital resource creation Originality/value 3 Previous work has argued that documentation is important. However, this paper presents actual evidence of the problems caused by a lack of documentation and shows that this makes reuse of digital resources almost impossible. This is intended to persuade project creators who wish resources to be reused to provide documentation about its contents and technical specifications.