DUQI (Document Utility and Quality Interrogator)

Collaborations Workshop 2019 (CW19) #CollabW19 2019-04-01 to 2019-04-03 Group 11 - CI3-CW2CC DUQI (Document Utility and Quality Interrogator) Reporter Adam Jackson Participants Douglas Lowe (douglas.lowe@manchester.ac.uk) Becky Arnold (rjarnold1@sheffield.ac.uk) Arshad Emmambux (a.emmambux@soton.ac.uk) Adam Jackson (a.j.jackson@physics.org) Diego Alonso-Álvarez (d.alonso-alvarez@imperial.ac.uk) Carina Haupt (carina.haupt@dlr.de) Context / Research Domain All research domains. Helping people improve their documentation. Specifically this should benefit small projects without established documentation practices. Problem A common question researchers trying to improve their code quality ask is “how do I know if what I’ve written is good, and how do I know what I need to improve?...

2 min · 393 words · Douglas Lowe, Becky Arnold, Arshad Emmambux, Adam Jackson, Diego Alonso-Álvarez, Carina Haupt

How do you motivate researchers to adopt better software practices?

Collaborations Workshop 2019 (CW19) #CollabW19 2019-04-01 to 2019-04-03 How do you motivate researchers to adopt better software practices? - DSR10-CW2CC Reporter Patrick McCann - pgm5@st-andrews.ac.uk Participants Rachael Ainsworth, Jason M. Gates (jmgate@sandia.gov), Jakob S. Jørgensen, Diego Alonso-Álvarez, Cerys Lewis Notes from the discussion Please use the area below to capture notes from the discussion session. How to get people out of bad habits, create good habits. “Reproducibility is like brushing your teeth”...

7 min · 1409 words · Rachael Ainsworth, Jason M. Gates, Jakob S. Jørgensen, Diego Alonso-Álvarez, Cerys Lewis

How to encourage and ensure software maintenance gets sufficiently funded

CW21 - 2021-03-30 Bagpuss - CI2-CW21 Participants Sorrel Harriet (Chair) Teri Forey (Scribe) Diego Alonso Álvarez Heather Turner Alexander Konovalov Ilian Todorov Ideas: _Tool or mechanism to add comments to code, or annotating the code with feedback without creating a pull request. Better space to provide guidance. _ _Nothing wrong with paired programming or code review, but it’s synchronous (have to find time that’s convenient to everyone). If it’s in a document there’s no easy way to link it to the line of code....

5 min · 1034 words · Sorrel Harriet, Teri Forey, Diego Alonso-Álvarez, Heather Turner, Alexander Konovalov, Ilian Todorov