{"id":1586,"date":"2020-09-14T14:56:09","date_gmt":"2020-09-14T12:56:09","guid":{"rendered":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/?p=1586"},"modified":"2020-09-30T17:02:35","modified_gmt":"2020-09-30T15:02:35","slug":"collecting-reader-feeback-with-paperhive-docloop-and-github","status":"publish","type":"post","link":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/2020\/09\/14\/collecting-reader-feeback-with-paperhive-docloop-and-github\/","title":{"rendered":"Collecting reader feedback with PaperHive, docLoop and GitHub"},"content":{"rendered":"\n<p>Back in 2017, we wrote a <a href=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/2017\/06\/27\/document-lifecycles-and-fluid-publication\/\">blog post on fluid publication<\/a>. This explained the development of a book by the author together with the readership, reusing techniques well-known from software development.<\/p>\n\n\n\n<p>The author 1) starts with a draft version, collects feedback from colleagues, and then the stages of  2) (open) review, 3) acceptance, 4) community proofreading and finally 5) publication of the first edition follow. A history of the different versions is kept on GitHub.  GitHub also provides functionalities to manage lists of open issues which still have to be addressed before the next stage can be initiated.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"alignright size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/langsci-press.org\/$$$call$$$\/submission\/cover\/cover?submissionId=271&amp;random=2715f5f52678f1c0\" alt=\"\" width=\"191\" height=\"269\" \/><\/figure><\/div>\n\n\n\n<p>As detailed in <a href=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/category\/proofreading\/\">various posts on this blog<\/a>, we use PaperHive for community proofreading. Today, we can showcase <a href=\"https:\/\/docloop.net\/\">docLoop<\/a>, which allows us to transform the community comments into todo lists on <a href=\"https:\/\/github.com\/langsci\/\">GitHub<\/a>, closing the loop from author to reader and back from the reader to the author. <\/p>\n\n\n\n<p>Let&#8217;s look at an example, <a href=\"https:\/\/langsci-press.org\/catalog\/book\/271\">Voice at the interfaces: The syntax, semantics, and morphology of the Hebrew verb<\/a> by Itamar Kastner. We can see the progress of this book on <a href=\"https:\/\/github.com\/langsci\/271\">its GitHub page<\/a>. The book was started in June 2018 and finalised in June 2020. Between the setup of the project and the publication, we count 259 different versions. Next to the author <em>itamarkast<\/em>, who provided 227 improved versions, <em>kopeckyf<\/em> and <em>Glottotopia<\/em> from the LangSci team provided 24 and 3 commits, respectively.<\/p>\n\n\n\n<figure class=\"wp-block-gallery columns-2 is-cropped wp-block-gallery-1 is-layout-flex wp-block-gallery-is-layout-flex\"><ul class=\"blocks-gallery-grid\"><li class=\"blocks-gallery-item\"><figure><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"948\" src=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-init-1024x948.png\" alt=\"\" data-id=\"1587\" data-full-url=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-init.png\" data-link=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/?attachment_id=1587\" class=\"wp-image-1587\" srcset=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-init-1024x948.png 1024w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-init-300x278.png 300w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-init-768x711.png 768w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-init-324x300.png 324w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-init.png 1272w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"blocks-gallery-item__caption\">The first commit of this repository, on May 17, 2018<br><\/figcaption><\/figure><\/li><li class=\"blocks-gallery-item\"><figure><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"813\" src=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-final-1024x813.png\" alt=\"\" data-id=\"1588\" data-full-url=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-final.png\" data-link=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/?attachment_id=1588\" class=\"wp-image-1588\" srcset=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-final-1024x813.png 1024w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-final-300x238.png 300w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-final-768x610.png 768w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-final-378x300.png 378w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastner-git-final.png 1255w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"blocks-gallery-item__caption\">The last commit to this repository, on June 12, 2020.<br><\/figcaption><\/figure><\/li><\/ul><\/figure>\n\n\n\n<!--more-->\n\n\n\n<p>Between the plan of the book, created on May 17, 2018, and the final publication in June 2020, the book grew from an outline to a respectable 286 page volume. The first full draft was completed on <a href=\"https:\/\/github.com\/langsci\/271\/commits\/master?after=5c81f6e6f4893fa2cff6e750428c123ae974ea4f+1&amp;branch=master\">July 24, 2019<\/a>. Between August and November 2019, we see a period of no activity, as the manuscript was under review then. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"538\" src=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/Screenshot_2020-09-14_13-39-37-1024x538.png\" alt=\"\" class=\"wp-image-1589\" srcset=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/Screenshot_2020-09-14_13-39-37-1024x538.png 1024w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/Screenshot_2020-09-14_13-39-37-300x158.png 300w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/Screenshot_2020-09-14_13-39-37-768x403.png 768w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/Screenshot_2020-09-14_13-39-37-1536x807.png 1536w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/Screenshot_2020-09-14_13-39-37-500x263.png 500w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/Screenshot_2020-09-14_13-39-37.png 1853w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>After the note of acceptance comes in in November, editing starts again until the manuscript reaches the community proofreading stage on April 22. Community proofreading is done via <a href=\"https:\/\/paperhive.org\/\">PaperHive<\/a>. A <a href=\"https:\/\/paperhive.org\/documents\/items\/2VgVFa73bREb\">total of 626 comments<\/a> were left by the community for this book. The following shows<a href=\"https:\/\/paperhive.org\/documents\/items\/2VgVFa73bREb?a=p:92\"> two comments by Bev Erasmus and Tom Bossuyt<\/a>, commenting on consistency and typography. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"391\" src=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/paperhive-1024x391.png\" alt=\"\" class=\"wp-image-1590\" srcset=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/paperhive-1024x391.png 1024w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/paperhive-300x115.png 300w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/paperhive-768x294.png 768w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/paperhive-500x191.png 500w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/paperhive.png 1426w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Our traditional workflow requires that authors go through the PaperHive document and take care of the comments as they go along, updating their manuscript. With docLoop, however, we can now harvest all those comments and put them in a nice <a href=\"https:\/\/github.com\/langsci\/271\/issues?q=is%3Aissue+is%3Aclosed+\">GitHub issue list<\/a>. The comment from Bev Erasmus above was harvested on May 22, addressed by the author on May 23 and <a href=\"https:\/\/github.com\/langsci\/271\/issues\/368\">marked as resolved (&#8220;closed&#8221;) on May 27<\/a> <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"838\" src=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/doclooperasmus-1024x838.png\" alt=\"\" class=\"wp-image-1591\" srcset=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/doclooperasmus-1024x838.png 1024w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/doclooperasmus-300x245.png 300w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/doclooperasmus-768x628.png 768w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/doclooperasmus-367x300.png 367w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/doclooperasmus.png 1353w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>The availability of all issues in a structured list allows for neat sorting and triaging. For instance, the author created the tag &#8220;help wanted&#8221; for issues he could not deal with himself. The author added &#8220;help wanted&#8221; to this issue on May 24, and the LangSci office resolved the problem on June 3 and closed the issue.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"1003\" src=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastnerkopecky-1024x1003.png\" alt=\"\" class=\"wp-image-1593\" srcset=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastnerkopecky-1024x1003.png 1024w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastnerkopecky-300x294.png 300w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastnerkopecky-768x752.png 768w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastnerkopecky-1536x1504.png 1536w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastnerkopecky-306x300.png 306w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/kastnerkopecky.png 1862w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"alignleft size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/langsci-press.org\/$$$call$$$\/submission\/cover\/cover?submissionId=148&amp;random=1485f5f617f98687\" alt=\"\" width=\"209\" height=\"294\" \/><\/figure><\/div>\n\n\n\n<p>Iterative publication does not end with the first edition, as explained in our <a href=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/2017\/06\/27\/document-lifecycles-and-fluid-publication\/\">2017 blogpost<\/a>. Readers will have feedback, and Paperhive allows us to collect this feedback. <a href=\"https:\/\/langsci-press.org\/catalog\/book\/148\">Corpus linguistics: A guide to the methodology<\/a> by Anatol Stefanowitsch was published in April 2020. On <a href=\"https:\/\/paperhive.org\/documents\/items\/4B_yoixNfIGd\">its Paperhive<\/a> page, readers have left comments, which have been <a href=\"https:\/\/github.com\/langsci\/148\/issues\">imported into GitHub<\/a> via docLoop so that these can be addressed for subsequent editions. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"110\" src=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang-1-1024x110.png\" alt=\"\" class=\"wp-image-1604\" srcset=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang-1-1024x110.png 1024w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang-1-300x32.png 300w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang-1-768x83.png 768w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang-1-500x54.png 500w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang-1.png 1403w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"616\" src=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang2-1-1024x616.png\" alt=\"\" class=\"wp-image-1605\" srcset=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang2-1-1024x616.png 1024w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang2-1-300x180.png 300w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang2-1-768x462.png 768w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang2-1-500x300.png 500w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/evang2-1.png 1385w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Readers do not have to learn anything about git, though. They can simply use the very user-friendly PaperHive web interface to leave their feedback. This feedback is then converted into structured issues for further processing. The following chart visualises the full loop.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"650\" src=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/elpubdocloopcycle-1024x650.png\" alt=\"\" class=\"wp-image-1599\" srcset=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/elpubdocloopcycle-1024x650.png 1024w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/elpubdocloopcycle-300x190.png 300w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/elpubdocloopcycle-768x487.png 768w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/elpubdocloopcycle-1536x975.png 1536w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/elpubdocloopcycle-2048x1300.png 2048w, https:\/\/userblogs.fu-berlin.de\/langsci-press\/files\/2020\/09\/elpubdocloopcycle-473x300.png 473w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>The development of docLoop was financed by the <a href=\"https:\/\/prototypefund.de\/\">ProtoType<\/a> fund, a great initiative which funds technologies for a more open and more inclusive world. <\/p>\n","protected":false},"excerpt":{"rendered":"<p>Back in 2017, we wrote a blog post on fluid publication. This explained the development of a book by the author together with the readership, reusing techniques well-known from software development. The author 1) starts with a draft version, collects &hellip; <a href=\"https:\/\/userblogs.fu-berlin.de\/langsci-press\/2020\/09\/14\/collecting-reader-feeback-with-paperhive-docloop-and-github\/\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":2177,"featured_media":1599,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[68809,682,68817,63148],"tags":[],"class_list":["post-1586","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-author","category-development","category-proofreading","category-publication"],"_links":{"self":[{"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/posts\/1586","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/users\/2177"}],"replies":[{"embeddable":true,"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/comments?post=1586"}],"version-history":[{"count":10,"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/posts\/1586\/revisions"}],"predecessor-version":[{"id":1608,"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/posts\/1586\/revisions\/1608"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/media\/1599"}],"wp:attachment":[{"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/media?parent=1586"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/categories?post=1586"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/userblogs.fu-berlin.de\/langsci-press\/wp-json\/wp\/v2\/tags?post=1586"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}