explain it n.
Download
Skip this Video
Loading SlideShow in 5 Seconds..
Explain it PowerPoint Presentation
Download Presentation
Explain it

Loading in 2 Seconds...

  share
play fullscreen
1 / 11
brody

Explain it - PowerPoint PPT Presentation

137 Views
Download Presentation
Explain it
An Image/Link below is provided (as is) to download presentation

Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server.

- - - - - - - - - - - - - - - - - - - - - - - - - - - E N D - - - - - - - - - - - - - - - - - - - - - - - - - - -
Presentation Transcript

  1. Explain it Why your Research deserves good documentation and metadata

  2. Why create documentation? • Creating documentation can seem like a waste of time • Good documentation will include a lot of information that might seem obvious www.flickr.com/photos/smutjespickles/2434418686/

  3. Make material understandable MAKE SURE YOU CAN UNDERSTAND IT LATER What’s obvious now might not be in a few months, years, decades… Image: http://www.flickr.com/photos/archer10/5692813531/

  4. Make material verifiable • Detailing your methods helps people understand what you did • Explaining your algorithms, search methods etc makes your work reproducible • Conclusions can be verified Image by woodleywonderworks on flickr: http://www.flickr.com/photos/wwworks/4588700881/

  5. Make material reusable • Material may be re-used by someone in a different discipline • Provide context to minimise the risk of it being misunderstood or misused

  6. Documentation & Metadata • Metadata are: • Machine readable • Written according to standards “I guess it makes sense for a robot to read an e-book [401]” by brianjmatis on flickr

  7. Make material findable • Comprehensive descriptive metadata allows relevant material to be discovered more easily • Related materials (eg other files) can be located

  8. What to include (I) • Who created it, when and why • Include: • Description of the item • Methodology • Units of measurement • References to related data ? www.texample.net M. Farinelli et al. (2012) PLoSONE 7(3): e34047 description n. A set of characteristics by which something can be recognised

  9. What to include (II) • Define jargon, acronyms and code CC Gavin Llewellyn http://www.flickr.com/photos/gavinjllewellyn/6826303487/ • Provide technicalinformation about the file • (may be generated automatically)

  10. Explain it • Create documentation to make data: • Understandable • Findable (and searchable) • Verifiable • Re-usable • Explain: • Who created it, when and why • Methodologies and analysis techniques • Jargon, acronyms and code

  11. Open Access Teaching Materials for Digital PreservationProduced by Anna Collins (2012) for the JISC-funded PrePARe project This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 2.0 UK: England & Wales License.