{"status":"ok","message-type":"work","message-version":"1.0.0","message":{"indexed":{"date-parts":[[2025,10,8]],"date-time":"2025-10-08T22:08:22Z","timestamp":1759961302163,"version":"3.41.2"},"reference-count":39,"publisher":"Emerald","issue":"1","license":[{"start":{"date-parts":[[2009,1,16]],"date-time":"2009-01-16T00:00:00Z","timestamp":1232064000000},"content-version":"tdm","delay-in-days":0,"URL":"https:\/\/www.emerald.com\/insight\/site-policies"}],"content-domain":{"domain":[],"crossmark-restriction":false},"short-container-title":[],"published-print":{"date-parts":[[2009,1,16]]},"abstract":"<jats:sec><jats:title content-type=\"abstract-heading\">Purpose<\/jats:title><jats:p>The purpose of this paper is to discuss the importance of documentation for digital humanities resources. This includes technical documentation of textual markup or database construction, and procedural documentation about resource construction.<\/jats:p><\/jats:sec><jats:sec><jats:title content-type=\"abstract-heading\">Design\/methodology\/approach<\/jats:title><jats:p>A case study is presented of an attempt to reuse electronic text to create a digital library for humanities users, as part of the UCIS project. The results of qualitative research by the LAIRAH study on provision of procedural documentation are discussed, as also is, user perception of the purpose, construction and usability of resources collected using semi\u2010structured interviews and user workshops.<\/jats:p><\/jats:sec><jats:sec><jats:title content-type=\"abstract-heading\">Findings<\/jats:title><jats:p>In 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.<\/jats:p><\/jats:sec><jats:sec><jats:title content-type=\"abstract-heading\">Practical implications<\/jats:title><jats:p>Creators of digital humanities resources should provide both technical and procedural documentation and make it easy to find, ideally from the project web site. 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.<\/jats:p><\/jats:sec><jats:sec><jats:title content-type=\"abstract-heading\">Originality\/value<\/jats:title><jats:p>Previous work has argued that documentation is important. However, the 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.<\/jats:p><\/jats:sec>","DOI":"10.1108\/00220410910926112","type":"journal-article","created":{"date-parts":[[2009,1,17]],"date-time":"2009-01-17T07:06:39Z","timestamp":1232175999000},"page":"33-57","source":"Crossref","is-referenced-by-count":5,"title":["Documentation and the users of digital resources in the humanities"],"prefix":"10.1108","volume":"65","author":[{"given":"Claire","family":"Warwick","sequence":"first","affiliation":[]},{"given":"Isabel","family":"Galina","sequence":"additional","affiliation":[]},{"given":"Jon","family":"Rimmer","sequence":"additional","affiliation":[]},{"given":"Melissa","family":"Terras","sequence":"additional","affiliation":[]},{"given":"Ann","family":"Blandford","sequence":"additional","affiliation":[]},{"given":"Jeremy","family":"Gow","sequence":"additional","affiliation":[]},{"given":"George","family":"Buchanan","sequence":"additional","affiliation":[]}],"member":"140","reference":[{"key":"key2022031519470104300_b1","unstructured":"AHDS History (n.d.), Guidelines for Documenting Data, available at: http:\/\/hds.essex.ac.uk\/docguide.asp."},{"key":"key2022031519470104300_b2","unstructured":"Beacham, R., Denard, H. and Niccolucci, F. (2006), \u201cAn introduction to the London Charter\u201d, The E\u2010volution of ICTechnology in Cultural Heritage, Joint Event CIPA\/VAST\/EG\/EuroMed Event, 2006, available at: www.londoncharter.org\/Beacham\u2010Denard\u2010Niccolucci_paper.doc."},{"key":"key2022031519470104300_b3","doi-asserted-by":"crossref","unstructured":"Butler, T., Fisher, S., Hockey, S., Coulombe, G., Clements, P., Brown, S., Grundy, I., Carter, K., Harvey, K. and Wood, J. (2000), \u201cCan a team tag consistently? Experiences on the Orlando project\u201d, Markup Languages Theory and Practice, Vol. 2 No. 2, pp. 111\u201025.","DOI":"10.1162\/10996620052104249"},{"key":"key2022031519470104300_b4","unstructured":"Daneker, I. and Warwick, C. (2005), \u201cA la carte schema: a case study comparison of the application of DTDs and XML schema to the Carte Calendar Project Template\u201d, in Liddell, P. (Ed.), The Association for Computers and the Humanities\u2010Association for Literary and Linguistic Computing, Conference, University of Victoria, Canada, June 15\u201018, pp. 50\u20103."},{"key":"key2022031519470104300_b5","unstructured":"Dempsey, L. and Weibel, S.L. (1996), \u201cThe Warwick Metadata workshop: a framework for the deployment of resource description\u201d, D\u2010Lib Magazine, July\/August, available at: www.ukoln.ac.uk\/dlib\/dlib\/july96\/0 7weibel.html."},{"key":"key2022031519470104300_b6","unstructured":"Dunning, A. (2007), \u201cRe: Documentation\u201d, e\u2010mail to Claire Warwick, 28 February."},{"key":"key2022031519470104300_b7","unstructured":"Frackoviak, M. (1999), \u201cEditing and TACT\u201d, available at: http:\/\/chss.montclair.edu\/\u223csotillos\/Tactpages\/editing.html."},{"key":"key2022031519470104300_b8","doi-asserted-by":"crossref","unstructured":"Giordano, R. (1995), \u201cThe TEI header and the documentation of electronic texts\u201d, Computers and the Humanities, Vol. 29 No. 1, pp. 75\u201084.","DOI":"10.1007\/BF01830317"},{"key":"key2022031519470104300_b9","doi-asserted-by":"crossref","unstructured":"Heery, R. (1996), \u201cReview of metadata formats\u201d, Program: Automated Library and Information Systems, Vol. 30 No. 4, pp. 345\u201073.","DOI":"10.1108\/eb047236"},{"key":"key2022031519470104300_b10","doi-asserted-by":"crossref","unstructured":"Hockey, S. (2004), \u201cThe history of humanities computing\u201d, in Siemens, R., Schreibman, S. and Unsworth, J. (Eds), Blackwell Companion to Digital Humanities, Blackwell, Oxford, pp. 3\u201019.","DOI":"10.1111\/b.9781405103213.2004.00004.x"},{"key":"key2022031519470104300_b11","doi-asserted-by":"crossref","unstructured":"Holscher, C. and Strube, G. (2000), \u201cWeb search behaviour of internet experts and newbies\u201d, Computer Networks, Vol. 33, pp. 337\u201046.","DOI":"10.1016\/S1389-1286(00)00031-1"},{"key":"key2022031519470104300_b12","unstructured":"IHR (2007), \u201cPeer review and evaluation of digital resources in the arts and humanities\u201d, Arts and Humanities Research Council, available at: www.history.ac.uk\/digit\/peer\/Peer_review_report2006.pdf."},{"key":"key2022031519470104300_b13","unstructured":"Kipp, M. and Campbell, D. (2006), \u201cPatterns and inconsistencies in collaborative tagging practices: an examination of tagging practices\u201d, Proceedings of the Annual General Meeting of the American Society for Information Science and Technology, Austin, Texas, November 3\u20108, 2006, available at: http:\/\/eprints.rclis.org\/archive\/00008315\/."},{"key":"key2022031519470104300_b14","unstructured":"Knight, J. (1997), \u201cMaking a MARC with Dublin Core\u201d, Ariadne, Vol. 8, available at: www.ariadne.ac.uk\/issue8\/marc\/intro.html."},{"key":"key2022031519470104300_b15","doi-asserted-by":"crossref","unstructured":"Lancashire, I. (1996), \u201cBilingual dictionaries in an English Renaissance knowledge base\u201d, Computers in the Humanities Working Papers, University of Toronto, Toronto, available at: www.chass.utoronto.ca\/epc\/chwp\/lancash1\/lan1_3.htm.","DOI":"10.16995\/dscn.221"},{"key":"key2022031519470104300_b16","doi-asserted-by":"crossref","unstructured":"Mahoui, M. and Cunningham, S\u2010J. (2001), \u201cSearch behavior in a research\u2010oriented digital library, research and advanced technology for digital libraries\u201d, Proceedings of 5th European Conference, ECDL 2001, Darmstadt, Germany, September 4\u20109, Lecture Notes in Computer Science, Vol. 2163, Springer, Berlin, Heidelberg, pp. 13\u201024.","DOI":"10.1007\/3-540-44796-2_2"},{"key":"key2022031519470104300_b17","unstructured":"Miller, P. (1996), \u201cMetadata for the masses\u201d, Ariadne, 5, available at: www.ariadne.ac.uk\/issue5\/metadata\u2010masses\/."},{"key":"key2022031519470104300_b18","unstructured":"Morkes, J. and Nielsen, J. (1997), \u201cConcise, SCANNABLE, and objective: how to write for the web\u201d, Useit.com, available at: www.useit.com\/papers\/webwriting\/writing.html."},{"key":"key2022031519470104300_b19","unstructured":"Morrison, A., Popham, M. and Wikander, K. (n.d.), Creating and Documenting Electronic Texts: Guide to Good Practice, AHDS Publications, available at: http:\/\/ota.ahds.ac.uk\/documents\/creating\/."},{"key":"key2022031519470104300_b21","unstructured":"NHS Executive (1998), Information for Health: An Information Strategy for the Modern NHS 1998\u20102005. A National Strategy for Local Implementation, Department of Health, London."},{"key":"key2022031519470104300_b20","unstructured":"Nielsen, J. and Tahir, M. (2001), Homepage Usability: 50 Websites Deconstructed, New Riders Publishing, Indianapolis, IN."},{"key":"key2022031519470104300_b22","unstructured":"Orna, E. (2005), Making Knowledge Visible, Gower, Aldershot."},{"key":"key2022031519470104300_b23","doi-asserted-by":"crossref","unstructured":"Palmer, C.L. and Neumann, L. (2002), \u201cThe information work of interdisciplinary humanities scholars: exploration and translation\u201d, Library Quarterly, Vol. 72, pp. 85\u2010117.","DOI":"10.1086\/603337"},{"key":"key2022031519470104300_b24","unstructured":"Popham, M. (1998), Oxford Text Archive Collections Policy \u2013 Version 1.1, AHDS Publications, available at: http:\/\/ota.ahds.ac.uk\/publications\/ID_AHDS\u2010Publications\u2010Collections\u2010Policy.html."},{"key":"key2022031519470104300_b25","doi-asserted-by":"crossref","unstructured":"Porcheret, M., Hughes, R., Evans, D., Jordan, K., Whitehurst, T., Ogden, H. and Croft, P. (2004), \u201cData quality of general practice electronic health records: the impact of a program of assessments, feedback, and training\u201d, Journal of the American Medical Informatics Association, Vol. 11, pp. 78\u201086.","DOI":"10.1197\/jamia.M1362"},{"key":"key2022031519470104300_b26","doi-asserted-by":"crossref","unstructured":"Probets, S. and Jenkins, C. (2006), \u201cDocumentation for institutional repositories\u201d, Learned Publishing, Vol. 19 No. 1, pp. 57\u201071.","DOI":"10.1087\/095315106775122556"},{"key":"key2022031519470104300_b27","doi-asserted-by":"crossref","unstructured":"Raskin, J. (2005), \u201cComments are more important than code\u201d, Queue, Vol. 3 No. 2, pp. 64\u20106.","DOI":"10.1145\/1053331.1053354"},{"key":"key2022031519470104300_b28","doi-asserted-by":"crossref","unstructured":"Sperberg\u2010McQueen, C.M. (1991), \u201cText in the electronic age: textual study and text encoding with examples from medieval texts\u201d, Literary and Linguistic Computing, Vol. 6 No. 1, pp. 32\u201046.","DOI":"10.1093\/llc\/6.1.34"},{"key":"key2022031519470104300_b29","unstructured":"Sperberg\u2010McQueen, C.M. and Burnard, L. (2002), \u201cA gentle introduction to XML\u201d, TEI P4: Guidelines for Electronic Text Encoding and Interchange, TEI Consortium, available at: www.tei\u2010c.org\/Guidelines2\/gentleintro.xml."},{"key":"key2022031519470104300_b31","unstructured":"TEI Consortium (2007), TEI P5: Guidelines for Electronic Text Encoding and Interchange, TEI Consortium, available at: www.tei\u2010c.org\/release\/doc\/tei\u2010p5\u2010doc\/html\/."},{"key":"key2022031519470104300_b30","unstructured":"Text Encoding Initiative (2001), Text Encoding Initiative, available at: www.tei\u2010c.org."},{"key":"key2022031519470104300_b32","unstructured":"Voss, J. (2007), \u201cTagging, Folksonomy & Co. \u2013 Renaissance of manual indexing?\u201d, Open Innovation, Proceedings of the 10th International Symposium for Information Science, Cologne, UVK, 30 May\u20101 June, pp. 243\u201054."},{"key":"key2022031519470104300_b33","doi-asserted-by":"crossref","unstructured":"Walsh, S.H. (2004), \u201cThe clinician's perspective on electronic health records and how they can affect patient care\u201d, British Medical Journal, Vol. 328, pp. 1184\u20107.","DOI":"10.1136\/bmj.328.7449.1184"},{"key":"key2022031519470104300_b34","doi-asserted-by":"crossref","unstructured":"Warwick, C., Blandford, A., Buchanan, G. and Rimmer, J. (2005), \u201cUser centred interactive search in the humanities\u201d, Proceedings of 5th ACM\/IEEE\u2010CS Joint Conference on Digital Libraries, ACM Press, New York, NY.","DOI":"10.1145\/1065385.1065503"},{"key":"key2022031519470104300_b36","unstructured":"Warwick, C., Terras, M., Huntington, P., Pappa, N. and Galina, I. (2007), The LAIRAH Project: Log Analysis of Digital Resources in the Arts and Humanities, Final Report to the Arts and Humanities Research Council, Arts and Humanities Research Council, available at: www.ahrcict.rdg.ac.uk\/activities\/strategy_projects\/reports\/index.htm."},{"key":"key2022031519470104300_b37","doi-asserted-by":"crossref","unstructured":"Wenger, E. (1999), Communities of Practice: Learning, Meaning and Identity, Cambridge University Press, Cambridge.","DOI":"10.1017\/CBO9780511803932"},{"key":"key2022031519470104300_b38","doi-asserted-by":"crossref","unstructured":"Witten, I.H., Bainbridge, D. and Boddie, S.J. (2001), \u201cGreenstone: open\u2010source digital library software\u201d, D\u2010Lib Magazine, Vol. 7 No. 10, available at: http:\/\/citeseer.ist.psu.edu\/witten01greenstone.html.","DOI":"10.1045\/october2001-witten"},{"key":"key2022031519470104300_b39","unstructured":"Woolard, M. (2007), \u201cRe: Documentation\u201d, e\u2010mail to Claire Warwick, 27 February."},{"key":"key2022031519470104300_frg35","unstructured":"Warwick, C., Terras, M., Galina, I., Huntington, P. and Pappa, N. (n.d.), \u201cIf you build it will they come? The LAIRAH study: quantifying the use of online resources in the arts and humanities through statistical analysis of user log data\u201d, Literary and Linguistic Computing, Vol. 13 No. 3."}],"container-title":["Journal of Documentation"],"original-title":[],"language":"en","link":[{"URL":"http:\/\/www.emeraldinsight.com\/doi\/full-xml\/10.1108\/00220410910926112","content-type":"unspecified","content-version":"vor","intended-application":"text-mining"},{"URL":"https:\/\/www.emerald.com\/insight\/content\/doi\/10.1108\/00220410910926112\/full\/xml","content-type":"application\/xml","content-version":"vor","intended-application":"text-mining"},{"URL":"https:\/\/www.emerald.com\/insight\/content\/doi\/10.1108\/00220410910926112\/full\/html","content-type":"unspecified","content-version":"vor","intended-application":"similarity-checking"}],"deposited":{"date-parts":[[2025,7,24]],"date-time":"2025-07-24T23:38:01Z","timestamp":1753400281000},"score":1,"resource":{"primary":{"URL":"http:\/\/www.emerald.com\/jd\/article\/65\/1\/33-57\/223577"}},"subtitle":[],"short-title":[],"issued":{"date-parts":[[2009,1,16]]},"references-count":39,"journal-issue":{"issue":"1","published-print":{"date-parts":[[2009,1,16]]}},"alternative-id":["10.1108\/00220410910926112"],"URL":"https:\/\/doi.org\/10.1108\/00220410910926112","relation":{},"ISSN":["0022-0418"],"issn-type":[{"type":"print","value":"0022-0418"}],"subject":[],"published":{"date-parts":[[2009,1,16]]}}}