Adrian Castravete

Collaborations Workshop 2019 (CW19) #CollabW19 2019-04-01 to 2019-04-03 Interoperability & Continuous Integration - DSR2-CW2CC Reporter Alejandra Gonzalez-Beltran - University of Oxford, http://agbeltran.github.io/,twitter: @alegonbel alejandra.gonzalez.beltran@gmail.com Participants Kirstie Whitaker, Alan Turing Institute, https://whitakerlab.github.io, twitter: @kirstie_j, kwhitaker@turing.ac.uk Mosè Giordano, UCL, https://giordano.github.io, Twitter: @MoseGiordano Richard Gilham (Met Office) richard.gilham@metoffice.gov.uk Aleksandra Nenadic, The Software Sustainability Institute, a.nenadic@manchester.ac.uk Alexander Konovalov, University of St Andrews, alexander.konovalov@st-andrews.ac.uk Adrian Castravete, figshare, adrian@figshare.com Notes from the discussion Please use the area below to capture notes from the discussion session....

Collaborations Workshop 2019 (CW19) #CollabW19 2019-04-01 to 2019-04-03 The Docutor button - CI18-CW2CC Reporter Dan Hobley - dan.hobley@gmail.com Participants Cerys Lewis, Connah Kendrick, Kirstie Whitaker, Adrian Castravete Context / Research Domain Documentation enhancement Problem In active projects, it’s very easy for documentation to get out of alignment with or superseded by subsequent code changes. Maintainers of open source projects are hugely overworked and underpaid, so even with the best will in the world, it’s very difficult for the experts who built the code and who wrote the original documentation to review it and catch any of the inconsistencies that appear over time....