Collaborative Creation of a Wikidata handbook (2014-08-28)

1

Collaborative Creation of aWikidata handbook

Jakob Voß

Verbunzentrale des GBV (VZG) & Hochschule Hannover

OpenSym (WikiSym), Berlin, 2014-08-28

Collaborative Creation of a Wikidata handbook (2014-08-28)

2

Normdaten in WikidataAuthority files in Wikidata

ISBN 978-1-291-85658-368 pages

Available as HTML, ePUB, PDF& print on demand

http://hshdb.github.io/

normdaten-in-wikidata/

Collaborative Creation of a Wikidata handbook (2014-08-28)

3

Topic: Authority files in Wikidata

I Wikidata

I Great wiki database that anyone can editI See tomorrow’s Wikidata talk for details!

I Authority files

I Also known as knowledge organization systems (SKOS)I Many authority properties & identifiers in Wikidata, e.g.:

I Dewey Decimal Classification: P1036

I ORCID author identifier: P496

I IMDb movie ID: P345I . . .

Collaborative Creation of a Wikidata handbook (2014-08-28)

4

Outline of the book

I Introduction (Wikidata, authority files)I Basic Wikidata concepts (items, properties, statements)I Authority files in WikidataI How to search, edit, configure, reuse WikidataI Glossary, FAQ, Bibliography

general Wikidata handbook

Collaborative Creation of a Wikidata handbook (2014-08-28)

5

Project Background

I Conducted by 9 students and meI 6th semester Bachelor of Information ManagementI Hannover University of Applied SciencesI March – June 2014 (13 meetings a 5 hours)

book sprint by non-experts

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 interfacesI task lists & appointmentsI less is more!

I Blackboard and paper cardsI Feedback by continuous builds

Collaborative Creation of a Wikidata handbook (2014-08-28)

7

Collaborative Writing

I Penflip

I Simple visual web editorI Markdown syntax with highlightingI Document stored as git repository (↔ local, GitHub. . . )

Collaborative Creation of a Wikidata handbook (2014-08-28)

8

Continuous builds

I Pandoc for document conversion(Markdown, HTML, LaTeX, ODT, DOCX, ePUB. . . )

edit (Penflip/git) → build (Pandoc) → deploy (HTML/PDF)

I Not fully supported by current toolsI Custom pre/post-processing required for specialized contentI Layout templating requires skills in LaTeX & HTM/CSS/JS

Collaborative Creation of a Wikidata handbook (2014-08-28)

9

Revision & Proofreading

I GitHub issues or Trello cards (not used)I Penflip issues (rarely used)I Annotator (great tool, but technical problems)

printed copies are still important

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, Penflip, git, Pandoc, Annotator)but difficult 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

Collaborative Creation of a Wikidata handbook (2014-08-28)

11

Lessons learned

I Creation of a handbook is possible with untrained studentsI Cross-media publishing (PDF, HTML, ePUB. . . ) is possibleI Required tools

I Project management (e.g. with Trello)I Collaborative Writing platform (e.g. Penflip)I Document conversion (Pandoc + custom scripts)I Proofreading & feedback (e.g. Annotator)

I But tools are just tools, people matter most

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-3urn: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