researchsoft / software-authorship-contribution

Repository for collaboration on software authorship definition and contribution roles aggregation
https://www.researchsoft.org/tf-authorship-contribution/
Other
5 stars 2 forks source link

License: CC BY 4.0

Software Authorship

:link: Website: https://sdruskat.net/software-authorship/

A Collaborations Workshop 2023 hack activity

The aims of this hack day activity are to define guidelines for authorship of software. This activity is necessary because existing authorship guidelines, e.g., for papers, are not easily transferable to software.

The new guidelines will define:

This activity focuses on authorship of software (“the software itself”). It does not discuss specifics of authorship for related outputs (software papers, papers about software, etc.).

Initial outputs

  1. A draft for a definition of authorship for research software. This draft will be proposed to the community to refine it and gain support from relevant stakeholders (such as FORCE11 and ReSA).
  2. A proposal for a list of authorship and contribution roles for software, and their relationship to existing roles taxonomies and lists. This also includes more detailed definitions of the single roles, including examples.

Ongoing work

We are in the process of forming a ReSA Task Force to continue the work started during the hack event.

The Task Force will work to involve the community in reviewing and contributing to the definition of software authorship and the taxonomy of software contribution roles, as detailed in the Roadmaps and contribution sections below.

Roadmaps

We consider both outputs of this work - a definition of software authorship, a taxonomy of software contribution roles - as open, living documents. Contributions from the community are welcome during the lifecycle of the Task Force.

Software authorship definition

The progress of this work is tracked in a dedicated GitHub project in this repository.

Outlined briefly, we will take the definition through a three-step process:

  1. Solicit reviews and contributions from invited expert reviewers.
  2. Prepare and publish a revised version of the definition.
  3. Run a consultation with the larger community to solicit further reviews and contributions.
  4. Prepare and publish another revised version of the definition.

Software contribution roles taxonomy

The progress of this work is tracked in a dedicated GitHub project in this repository.

Outlined briefly, we will take the definition through a two-step process:

  1. Solicit contributions from the larger community for additional existing taxonomies to consider, compare and crosswalk.
  2. Prepare and publish the revised version of the taxonomy.

When and how to contribute to this work?

We will publish invitations for the community to contribute to this work at given points in time outlined in the Roadmaps. Specifically, we are very interested in your contributions if you have experience in research (software) policy, open source communities or contributions, contribution taxonomies.

In the meantime, please create an issue if you have ideas to contribute to this repository. However, please be aware that we may only be able to discuss your ideas in depth at a specific point in time as outlined in the Roadmaps.

Contributors

The contributors to the Collaborations Workshop 2023 Hack Day work were:

Resources

Following is a list of resources we have used to develop the contents on this repository:

Code of Conduct

We are following the Collaborations Workshop 2023 code of conduct for this project.

Cite this project

Leem, Deborah, Turon, Gemma, Gruson, Hugo, Chue Hong, Neil, Kaur Bhogal, Saranjeet, Lo, Sherman, Druskat, Stephan, & Soiland-Reyes, Stian. (2023). SORTÆD: Software Role Taxonomy and Authorship Definition. Zenodo. https://doi.org/10.5281/zenodo.7896455