Feedback requested: a short implementation examples paper

[arfon]

As one of the four final actions of this working group we (@arfon, @danielskatz & @kyleniemeyer) are considering writing a short implementation examples paper that demonstrates how to implement the software citation principles in a small number of common situations/scenarios. For example:

How to make your software citable

• Discuss GitHub to Zenodo linkage and required metadata

In a paper

• When the software being cited has a DOI
• When the software being cited doesn't have a DOI (but is perhaps on e.g. GitHub)
• Citing commercial or closed source software
• Citing software that is only available as a service
• When the software being cited has a paper and a DOI
• What does a bibTeX entry look like for all of the above (fixes bibtex entry #148)

We'd like your help in two main ways:

• If you have suggestions for which small number of use cases would be most valuable to discuss in this paper then please suggest them here (see this section for the full list of use cases we discussed).
• If you're interested in helping substantially with this effort (i.e., actually willing to help write a paper with us) then please say so on this thread.

[nalsi]

Hi Afron,

My name is Kai Li. I am a PhD student in Information Science at Drexel University. I have never talked in this group. But I am very interested in this project, which is an area I am doing some studies myself. Two other faculty members in my school and myself recently finished a case study on the citation of LAMMPS, a popular software in material science.

So I would love to participate in this project if possible!

[tomcrick]

Happy to help with the writing of the paper.

[ljhwang]

+1

[iliant]

Hi Afron,

As I have mentioned at WSSSPE2, in the world of materials modelling software the most popular cases is that the software doesn't have a DOI but has a paper. The code can be open source, closed source and most often it is on an open source restrictive licence (artistic, preserving a sole distribution body, commercial rights, intellectual rights). I am happy to describe the rational behind these mainstreams.

Also, within my institution there are practices that unfold onto DOI + possibly a paper for service oriented software as well as citing a web-page for numerical libraries. I am sure I can provide example of those or find a best person to provide information.

[mhucka]

Thank you for organizing this effort. I'd be interested in contributing to this effort in some small way, such as helping with the paper or specific citation formats (perhaps related to #148).

[cm-j0nes]

I am really interested in the area of transferring theory to practice and am happy to contribute to writing the paper.

I have worked with others in my organisation who have tried to encourage software citation, and have used them as an example in the past - if you think this would be useful, then I can contact them to see if they are interested in contributing this as a use case.

[lnielsen]

We're happy to help out with the "How to make your software citable", especially given the latest update to the Zenodo GitHub integration.