<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Archiving and Interchange DTD v1.0 20120330//EN" "JATS-archivearticle1.dtd">
<article xmlns:xlink="http://www.w3.org/1999/xlink">
  <front>
    <journal-meta />
    <article-meta>
      <title-group>
        <article-title>Lightning Talk: “I solemnly pledge”</article-title>
      </title-group>
      <contrib-group>
        <contrib contrib-type="author">
          <string-name>Alice Allen</string-name>
          <xref ref-type="aff" rid="aff14">14</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Cecilia Aragon</string-name>
          <xref ref-type="aff" rid="aff18">18</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Christophe Becker</string-name>
          <xref ref-type="aff" rid="aff17">17</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Jeffrey C. Carver</string-name>
          <xref ref-type="aff" rid="aff10">10</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Andrei Chis</string-name>
          <xref ref-type="aff" rid="aff11">11</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Benoit Combemale</string-name>
          <xref ref-type="aff" rid="aff3">3</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Mike Croucher</string-name>
          <xref ref-type="aff" rid="aff15">15</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Kevin Crowston</string-name>
          <xref ref-type="aff" rid="aff6">6</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Daniel Garijo</string-name>
          <xref ref-type="aff" rid="aff7">7</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Ashish Gehani</string-name>
          <xref ref-type="aff" rid="aff5">5</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Carole Goble</string-name>
          <xref ref-type="aff" rid="aff8">8</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Robert Haines</string-name>
          <xref ref-type="aff" rid="aff8">8</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Robert Hirschfeld</string-name>
          <xref ref-type="aff" rid="aff1">1</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>James Howison</string-name>
          <xref ref-type="aff" rid="aff16">16</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Kathryn Huff</string-name>
          <xref ref-type="aff" rid="aff12">12</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Caroline Jay</string-name>
          <xref ref-type="aff" rid="aff8">8</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Daniel S. Katz</string-name>
          <xref ref-type="aff" rid="aff13">13</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Claude Kirchner</string-name>
          <xref ref-type="aff" rid="aff2">2</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Kateryna Kuksenok</string-name>
          <xref ref-type="aff" rid="aff18">18</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Ralf Lämmel</string-name>
          <xref ref-type="aff" rid="aff9">9</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Oscar Nierstrasz</string-name>
          <xref ref-type="aff" rid="aff11">11</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Matthew Turk</string-name>
          <xref ref-type="aff" rid="aff13">13</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Rob V. van Nieuwpoort</string-name>
          <xref ref-type="aff" rid="aff4">4</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Matthew Vaughn</string-name>
          <xref ref-type="aff" rid="aff16">16</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>Jurgen Vinju</string-name>
          <xref ref-type="aff" rid="aff0">0</xref>
        </contrib>
        <aff id="aff0">
          <label>0</label>
          <institution>CWI Amsterdam</institution>
          ,
          <country country="NL">The Netherlands</country>
        </aff>
        <aff id="aff1">
          <label>1</label>
          <institution>Hasso-Plattner-Institut</institution>
          ,
          <addr-line>Potsdam</addr-line>
          ,
          <country country="DE">Germany</country>
        </aff>
        <aff id="aff2">
          <label>2</label>
          <institution>INRIA</institution>
          ,
          <addr-line>Le Chesnay</addr-line>
          ,
          <country country="FR">France</country>
        </aff>
        <aff id="aff3">
          <label>3</label>
          <institution>IRISA</institution>
          ,
          <addr-line>Rennes</addr-line>
          ,
          <country country="FR">France</country>
        </aff>
        <aff id="aff4">
          <label>4</label>
          <institution>Netherlands eScience Center</institution>
          ,
          <addr-line>Amsterdam</addr-line>
          ,
          <country country="NL">The Netherlands</country>
        </aff>
        <aff id="aff5">
          <label>5</label>
          <institution>SRI</institution>
          ,
          <addr-line>Menlo Park</addr-line>
          ,
          <country country="US">USA</country>
        </aff>
        <aff id="aff6">
          <label>6</label>
          <institution>Syracuse University</institution>
          ,
          <country country="US">USA</country>
        </aff>
        <aff id="aff7">
          <label>7</label>
          <institution>Technical University of Madrid</institution>
          ,
          <country country="ES">Spain</country>
        </aff>
        <aff id="aff8">
          <label>8</label>
          <institution>The University of Manchester</institution>
          ,
          <country country="UK">UK</country>
        </aff>
        <aff id="aff9">
          <label>9</label>
          <institution>Universität Koblenz-Landau</institution>
          ,
          <country country="DE">Germany</country>
        </aff>
        <aff id="aff10">
          <label>10</label>
          <institution>University of Alabama</institution>
          ,
          <country country="US">USA</country>
        </aff>
        <aff id="aff11">
          <label>11</label>
          <institution>University of Bern Switzerland</institution>
        </aff>
        <aff id="aff12">
          <label>12</label>
          <institution>University of California</institution>
          ,
          <addr-line>Berkeley</addr-line>
          ,
          <country country="US">USA</country>
        </aff>
        <aff id="aff13">
          <label>13</label>
          <institution>University of Illinois</institution>
          ,
          <addr-line>Urbana-Champaign</addr-line>
          ,
          <country country="US">USA</country>
        </aff>
        <aff id="aff14">
          <label>14</label>
          <institution>University of Maryland</institution>
          ,
          <country country="US">USA</country>
        </aff>
        <aff id="aff15">
          <label>15</label>
          <institution>University of Sheffield</institution>
          ,
          <country country="UK">UK</country>
        </aff>
        <aff id="aff16">
          <label>16</label>
          <institution>University of Texas</institution>
          ,
          <addr-line>Austin</addr-line>
          ,
          <country country="US">USA</country>
        </aff>
        <aff id="aff17">
          <label>17</label>
          <institution>University of Toronto</institution>
          ,
          <country country="CA">Canada</country>
        </aff>
        <aff id="aff18">
          <label>18</label>
          <institution>University of Washington</institution>
          ,
          <addr-line>Seattle</addr-line>
          ,
          <country country="US">USA</country>
        </aff>
      </contrib-group>
      <abstract>
        <p>- Software is fundamental to academic research work, both as part of the method and as the result of research. In June 2016 25 people gathered at Schloss Dagstuhl for a week-long Perspectives Workshop and began to develop a manifesto which places emphasis on the scholarly value of academic software and on personal responsibility. Twenty pledges cover the recognition of academic software, the academic software process and the intellectual content of academic software. This is still work in progress. Through this lightning talk, we aim to get feedback and hone these further, as well as to inspire the WSSSPE audience to think about actions they can take themselves rather than actions they want others to take. We aim to publish a more fully developed Dagstuhl Manifesto by December 2016. Index Terms-software, manifesto.</p>
      </abstract>
    </article-meta>
  </front>
  <body>
    <sec id="sec-1">
      <title>I. INTRODUCTION</title>
      <p>Software is fundamental to academic research work, both as
part of the method and as the result of research. With the
advent of artifact evaluation committees of conferences, journals
that include source code and running systems as part of the
published artifacts, as well as the increasing push to
reproducibility, we foresee that software will only increase in importance
as part of the academic process.</p>
      <p>In June 2016, 25 people gathered at Schloss Dagstuhl for a
weeklong Perspectives Workshop [1] to produce a roadmap
towards future professional software engineering for
softwarebased research instruments and other software produced and
This work is licensed under a CC-BY-4.0 license.
used in an academic context (i.e., for research, not
administration). The group was carefully picked to be broad in its range
of disciplines (including Astronomy, Social Sciences, Biology,
Chemistry, Computer Science, Physics, and Humanities), roles
(including computer science researchers, general and specialist
research software engineers and systems administrators) and
career stages (from PIs and institute heads to PhD students and
postdocs). Despite its ambiguous title, “Engineering Academic
Software,” the workshop was on the Engineering of Academic
Software (not software for engineers).</p>
      <p>A Dagstuhl Perspectives Workshop results in a Manifesto.
The open science and research software communities have
been very active in creating manifestos: the Science Code
Manifesto [2], Karlskrona Manifesto for Sustainability Design [3],
the Reproducibility Manifesto [4], and Principles for Software
Citation [5], FAIR data [6], and so on. Why do we need
another Manifesto?</p>
      <p>First, our manifesto is to be less about what others should
do, and more about what we, as individuals, should do. That is,
it is more in the style of a personal responsibility pledge like
those on open access [7] and open peer review [8]. It is easy for
us to declare “the community should do X”, “funding panels
should do Y” and “promotion committees should do Z”, while
conveniently forgetting that we are the community, we are the
panelists, we are the committee members.</p>
      <p>Second, our manifesto places emphasis on the scholarly
value of academic software. For some of our group,
engineering academic software is chiefly a means to an end – to
produce robust and reliable software as an instrument as part of a
wider research investigation. For others the software is the end
in itself – the software is the research. In both cases the
software has scholarly merit.</p>
    </sec>
    <sec id="sec-2">
      <title>II. THE DRAFT PERSONAL MANIFESTO</title>
      <p>Currently at 20 there are too many pledges so we are
actively working on reducing the number and simplifying the
message. At the WSSSPE4 meeting, through this lightning talk, we
aim to get feedback and contribute to this process.</p>
      <p>
        Table I presents our pledge list organized into three broad
areas: (
        <xref ref-type="bibr" rid="ref1">1</xref>
        ) recognition of academic software, (
        <xref ref-type="bibr" rid="ref2">2</xref>
        ) academic
software development processes and (
        <xref ref-type="bibr" rid="ref3">3</xref>
        ) the intellectual content of
academic software. Each pledge should be actionable by an
individual. Each pledge has a story that will be developed in
the full manifesto.
      </p>
      <sec id="sec-2-1">
        <title>A. Recognition of academic software</title>
        <p>I will properly cite software used to produce my research results
I will point out improper or missing citations to software when I am
reviewing publications.</p>
        <p>I will make explicit how to cite the software I make available.
I will recommend software experts for funding agencies to include in
their review processes.</p>
        <p>I will invite developers of software that enables my research to be
coauthors on my papers.</p>
        <p>I will recognize software contributions in hiring and promotion within
my institution.</p>
        <p>I will recognize software contributions at conferences, e.g. dedicated
sessions, and prizes.</p>
        <p>I will support and publish in journals that recognise software
contributions.</p>
        <p>I will contribute to sustaining the software I rely on for my research.</p>
      </sec>
      <sec id="sec-2-2">
        <title>B. Academic software development processes</title>
        <p>I will develop software as open source right from the start whenever
possible.</p>
        <p>I will document my academic software for users with instructions and
examples.</p>
        <p>I will package, release and archive versions of my software
I will consider and document the sustainability of my research software.
I will publish how I organize and run my software projects
I will match software engineering practices I recommend to the needs
and resources of projects.</p>
        <p>I will help scientists improve the quality of their software without passing
judgment.</p>
      </sec>
      <sec id="sec-2-3">
        <title>C. The intellectual content of academic software</title>
        <p>17</p>
        <p>I will acknowledge that source code is a legitimate part of the academic
discourse.</p>
        <p>I will publish the intellectual contributions of my research software.
I will distinguish the intellectual contribution of my software from its
service contribution.</p>
        <p>I will examine the source code of academic software contributions and
encourage others to do so as well.</p>
        <p>
          The pledges A and B (
          <xref ref-type="bibr" rid="ref1 ref2 ref3 ref4 ref5 ref6 ref7 ref8 ref9">1-16</xref>
          ) are targeted at both developers
and users of academic software; pledges C (17-20) are more
focused on developers. Pledges to recognize software are
selfevidently responsibilities to be borne by users. Perhaps more
implicit are the benefits to users embedded in the software
development processes. Open source (10) and documentation
(11) enables feedback and potential community engagement
during critical design stages, and examples and instructions by
their definition must embed an understanding of use cases and
usability pitfall. Improving transparency of process, and
analytic consideration of future use cases (12, 13, 14) are valid
usercentered approaches and (15, 16) directly speak to assessing
user needs and crafting appropriate interventions.
        </p>
      </sec>
    </sec>
    <sec id="sec-3">
      <title>III. NEXT STEPS</title>
      <p>
        This is still work in progress. We recognize that 20 pledges
is roughly twice as many as desirable, and that the pledges need
to be succinct and easy to understand and adopt, more in the
style of the Reproducibility Manifesto [4]. We are currently (
        <xref ref-type="bibr" rid="ref1">1</xref>
        )
looking to merge pledges where feasible and (
        <xref ref-type="bibr" rid="ref2">2</xref>
        ) exploring the
use of roles to structure them; for example “When I develop
software ...When I write research papers ...When I evaluate
colleagues ...” and so on. At WSSSPE we intend to run an
online vote on the pledges structured on roles.
      </p>
      <p>We aim to develop the full manifesto by December 2016
and publish it as a Dagstuhl Manifesto [9]. We intend that
community groups promote its contents among researchers and
research software engineers, and we use it to influence decision
makers to enable our respective communities to execute these
pledges with moral and financial support.</p>
    </sec>
    <sec id="sec-4">
      <title>ACKNOWLEDGMENT</title>
      <p>We thank Schloss Dagstuhl – Leibniz-Zentrum für Informatik
GmbH for supporting and hosting Workshop 16252.</p>
    </sec>
  </body>
  <back>
    <ref-list>
      <ref id="ref1">
        <mixed-citation>
          [1]
          <string-name>
            <given-names>Engineering</given-names>
            <surname>Academic</surname>
          </string-name>
          <string-name>
            <surname>Software</surname>
          </string-name>
          ,
          <source>Dagstuhl Perspectives Workshop</source>
          <volume>16252</volume>
          ,
          <fpage>19</fpage>
          -
          <lpage>24</lpage>
          June 2016, http://www.dagstuhl.de/16252 last accessed 07-Jul-2016
        </mixed-citation>
      </ref>
      <ref id="ref2">
        <mixed-citation>[2] Science code manifesto http://sciencecodemanifesto.org/</mixed-citation>
      </ref>
      <ref id="ref3">
        <mixed-citation>
          [3]
          <string-name>
            <given-names>Karlskrona</given-names>
            <surname>Manifesto</surname>
          </string-name>
          for Sustainability Design http://sustainabilitydesign.org/
        </mixed-citation>
      </ref>
      <ref id="ref4">
        <mixed-citation>[4] Reproducibility manifesto http://lorenabarba.com/gallery/reproducibility-pi-manifesto/</mixed-citation>
      </ref>
      <ref id="ref5">
        <mixed-citation>
          [5]
          <string-name>
            <given-names>A.M.</given-names>
            <surname>Smith</surname>
          </string-name>
          ,
          <string-name>
            <given-names>D.S.</given-names>
            <surname>Katz</surname>
          </string-name>
          ,
          <string-name>
            <given-names>K.E.</given-names>
            <surname>Niemeyer</surname>
          </string-name>
          , FORCE11 Software Citation Working Group. (
          <year>2016</year>
          )
          <article-title>Software citation principles</article-title>
          .
          <source>PeerJ Preprints</source>
          <volume>4</volume>
          :e2169v3 https://doi.org/10.7287/peerj.preprints.2169v3
        </mixed-citation>
      </ref>
      <ref id="ref6">
        <mixed-citation>
          [6]
          <string-name>
            <surname>M.D.</surname>
          </string-name>
          Wilkinson et al.
          <article-title>The FAIR guiding principles for scientific data management and stewardship (2016) Scientific Data 3</article-title>
          ,
          <string-name>
            <surname>Article</surname>
            <given-names>number</given-names>
          </string-name>
          :
          <volume>160018</volume>
          (
          <year>2016</year>
          ) doi:10.1038/sdata.
          <year>2016</year>
          .18
        </mixed-citation>
      </ref>
      <ref id="ref7">
        <mixed-citation>[7] Open access pledge http://www.openaccesspledge.com/</mixed-citation>
      </ref>
      <ref id="ref8">
        <mixed-citation>[8] Open science peer review oath http://f1000research.com/articles/3-271/v2</mixed-citation>
      </ref>
      <ref id="ref9">
        <mixed-citation>[9] Dagstuhl manifestos http://www.dagstuhl.de/en/publications/dagstuhl-manifestos</mixed-citation>
      </ref>
    </ref-list>
  </back>
</article>