New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Goal of this A&P document/process #62

Open
danielskatz opened this Issue Oct 4, 2018 · 11 comments

Comments

Projects
None yet
7 participants
@danielskatz
Collaborator

danielskatz commented Oct 4, 2018

Based on discussion in Section 1 of A&P google doc

  • What's the goal of this document? And how does this related to the software citation principles document? Are we creating an updated set of principles? Determining the work the FORCE11 group now needs to do? Adding detail beyond what's in the software citation principles?
  • Perhaps think about this as the next layer of the discussion?
  • List of challenges? Guidance for the group on how to address challenges?
  • A way to organize guidance that we provide to others? (and to explain where we still have questions and uncertainties)
  • Ultimately it should prove a number of case studies where examples from different communities, software projects in different languages manage to get the software citation principles as closely implemented as possible. (Ilian)
@AlastairKelly

This comment has been minimized.

AlastairKelly commented Oct 4, 2018

I think primarily it is that fourth bullet point: A way to organize guidance that we provide to others, and to explain where we still have questions and uncertainties. I think community-specific examples will be part of that. (fifth bullet)
For our working purposes, it organizes the guidance we need to develop and write.
(Secondarily, it seems to also be helping clarify our scope and unify our language!)

@moranegg

This comment has been minimized.

Contributor

moranegg commented Oct 8, 2018

I believe the document should be next step after the software citation principles on how to cite software. In the principles a couple of citation use cases are described an a set of guiding principles were defined.
Still we lack specific tools and recommendations.
As a next layer, guidance to different actors on what's already available and what needs to be discussed and developed.

i agree with @AlastairKelly, that it will be also great to unify our language with this document, even if we don't agree on the usage of every term, we will have some clear definitions.

@lkellogg

This comment has been minimized.

lkellogg commented Nov 12, 2018

I suggest that we have a subsection of the Introduction (Section 1) called "Purpose and Goals of this Document". The idea would be to help readers identify who should read this document and how they should use it.

For example: software developers: they will use this document to stay up to date on practices they should be using. Editors of journals or peer-reviewers: they will use this document to see if the software used in publications is being cited properly. And so on.

There is currently some info about this in Section 6.1 (still in list rather than narrative form).

@npch

This comment has been minimized.

Collaborator

npch commented Nov 27, 2018

On the call, @lkellogg @dbouquin @npch and @danielskatz suggested that the document should be aimed primarily at those stakeholders who had a level of expertise or championing that was above that of the "ordinary" person who wished to understand how to do a specific software citation use case (these people would be pointed to other slimmer, more specific primers).

These people might be those at communities, institutions or journals who support researchers, or software citation champions.

It would present a view of the current state of software citation practice and enable these stakeholders to get up to speed with the current practice of software citation, the language and terminology that is being used, and the challenges that are still to be addressed.

(NB: I think of this as being the difference between user documentation and developers documentation)

@danielskatz

This comment has been minimized.

Collaborator

danielskatz commented Nov 27, 2018

Another question is where this document goes, what we do with it, and how updates/follow-ons are made:

Options

  • web page
  • wiki
  • paper
  • preprint
  • series of preprints

Ideas:

  • communities might build further documents based on this, more specific for their communities
  • later versions of this will need be written, maybe with small changes
@dbouquin

This comment has been minimized.

Contributor

dbouquin commented Nov 27, 2018

@dbouquin will try drafting purpose statement along with Issue 65

@dbouquin

This comment has been minimized.

Contributor

dbouquin commented Dec 4, 2018

Draft:
Principles to guide software citation practices have not fully mitigated issues that impact software citation implementation. This document provides an explanation of current issues impacting scholarly attribution of research software, organizes updated implementation guidance, and identifies where best practices and solutions are still needed.

@ljhwang

This comment has been minimized.

ljhwang commented Dec 5, 2018

@danielskatz

This comment has been minimized.

Collaborator

danielskatz commented Dec 18, 2018

Are we comfortable that Closed Source is always associated with a Company? In both cases is “entity” (or another term) perhaps a better generalization?

I don't see what you are referring to, can you tell me what section(s)? In general, I agree with you.

Similarly, are we comfortable citing specific technologies? For example, is Software Heritage the only or just best method to achieve goals?

Good question - right now, it seems like the only way, but we should probably generalize a little too.

@ljhwang

This comment has been minimized.

ljhwang commented Dec 18, 2018

wrt "Company" - The comment was probably tied to your comments in section 3.1 from the point of naivete on what else may fall under this category and how they may track releases. Are there noncorporate entities that have closed source software?

@danielskatz

This comment has been minimized.

Collaborator

danielskatz commented Dec 18, 2018

I feel like the "perhaps" language makes this ok. If you have something additional to suggest to make this clearer, please make a suggestion in the document.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment