Presentation about the creation of a German handbook on Wikidata and authority files. Accepted at OpenSym (WikiSym) conference 2014 (August 28th). More about the book at http://hshdb.github.io/normdaten-in-wikidata/
1. Collaborative Creation of a Wikidata handbook (2014-08-28)
1
Collaborative Creation of a
Wikidata handbook
Jakob Vo
Verbunzentrale des GBV (VZG) Hochschule Hannover
OpenSym (WikiSym), Berlin, 2014-08-28
14. Collaborative Creation of a Wikidata handbook (2014-08-28)
5
Project Background
I Conducted by 9 students and me
I 6th semester Bachelor of Information Management
I Hannover University of Applied Sciences
I March { June 2014 (13 meetings a 5 hours)
book sprint by non-experts
15. Collaborative Creation of a Wikidata handbook (2014-08-28)
6
Project management
I Face-to-face meetings discussion (rarely mail)
I Trello for organizing
I intuitive interfaces
I task lists appointments
I less is more!
I Blackboard and paper cards
I Feedback by continuous builds
16. Collaborative Creation of a Wikidata handbook (2014-08-28)
7
Collaborative Writing
I Pen
ip
I Simple visual web editor
I Markdown syntax with highlighting
I Document stored as git repository ($ local, GitHub. . . )
17. Collaborative Creation of a Wikidata handbook (2014-08-28)
8
Continuous builds
I Pandoc for document conversion
(Markdown, HTML, LaTeX, ODT, DOCX, ePUB. . . )
edit (Pen
ip/git) ! build (Pandoc) ! deploy (HTML/PDF)
I Not fully supported by current tools
I Custom pre/post-processing required for specialized content
I Layout templating requires skills in LaTeX HTM/CSS/JS
18. Collaborative Creation of a Wikidata handbook (2014-08-28)
9
Revision Proofreading
I GitHub issues or Trello cards (not used)
I Pen
ip issues (rarely used)
I Annotator (great tool, but technical problems)
printed copies are still important
19. Collaborative Creation of a Wikidata handbook (2014-08-28)
10
Shortcomings
I Non-experts need time to get familiar with the topic
I better mix of experts and newbies
I Great tools (Trello, Pen
ip, git, Pandoc, Annotator)
but dicult integration stability
I report bugs feature requests
I Missing connection Trello $ Document (in git)
I workarounds may exist
I Moving around rearranging content poorly supported
(as envisioned with Hypertext by Ted Nelson)
I open research topic in collaborative writing
20. Collaborative Creation of a Wikidata handbook (2014-08-28)
11
Lessons learned
I Creation of a handbook is possible with untrained students
I Cross-media publishing (PDF, HTML, ePUB. . . ) is possible
I Required tools
I Project management (e.g. with Trello)
I Collaborative Writing platform (e.g. Pen
ip)
I Document conversion (Pandoc + custom scripts)
I Proofreading feedback (e.g. Annotator)
I But tools are just tools, people matter most
21. Collaborative Creation of a Wikidata handbook (2014-08-28)
12
References
book Vo, Jakob et al. (2014). Normdaten in Wikidata.
ISBN 978-1-291-85658-3
urn:nbn:de:bsz:960-opus4-4381
paper Vo, Jakob (2014). Collaborative creation of a
Wikidata handbook.
sources at GitHub (book, paper slides)
http://hshdb.github.io/normdaten-in-wikidata/
https://github.com/jakobib/opensym2014