Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.
Sign upsuggestions and comments #98
Conversation
What are your thoughts on the comments I've made? |
|
||
Citing software helps further research and improves access to research software in order to: | ||
|
||
- support proper attribution and credit | ||
- support collaboration and reuse | ||
- enable reproducibility of findings | ||
- foster faster and more efficient research progress, and | ||
- [DSK: this seems to duplicate the statement above the bullets] foster faster and more efficient research progress, and |
This comment has been minimized.
This comment has been minimized.
npch
Jan 13, 2020
Collaborator
Perhaps. I think there's a difference, but maybe it needs to be more clearly worded. Should this be focussed on the "building on the shoulders of giants" aspect?
This comment has been minimized.
This comment has been minimized.
- provide the means to share software and data with future researchers | ||
|
||
FORCE11 has been developing guidance to support software citation. The Software Citation Principles (Smith et al 2016) were written to encourage broad adoption of a consistent policy for software citation across disciplines and venues. The Software Citation Checklist for Authors (Chue Hong et al 2019) and Software Citation Checklist for Developers provide more practical information for those seeking to improve their practice. | ||
FORCE11 has been developing guidance to support [DSK: implement?] software citation. The Software Citation Principles (Smith et al. 2016) were written to encourage broad adoption of a consistent policy for software citation across disciplines and venues. The Software Citation Checklist for Authors (Chue Hong et al. 2019a) and Software Citation Checklist for Developers (Chue Hong et al. 2019b) provide more practical information for those seeking to improve their practice. |
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
danielskatz
Jan 13, 2020
Author
Collaborator
I assume you mean the 2nd reference? What about implement vs support?
|
||
- Creator: the authors or project that developed the software | ||
- Title: the name of the software | ||
- Identifier: a resolvable pointer to the software | ||
- Identifier: a [DSK: persistent?] resolvable pointer to the software [DSK: or to a landing page?] |
This comment has been minimized.
This comment has been minimized.
npch
Jan 13, 2020
Collaborator
My view here is that whilst we should make it clear that PIDs are better, it is the provision of a resolvable identifier that is the significant cultural change. I agree on the point that it could point to a landing page, but we need to write that in a term that someone unfamiliar with PID metadata would understand.
This comment has been minimized.
This comment has been minimized.
danielskatz
Jan 13, 2020
Author
Collaborator
Maybe we could say "Ideally, this would be a persistent pointer to a landing page, similar to a DOI for a paper that points to a page about the paper rather than directly to the PDF"
@@ -30,6 +30,8 @@ It may also be desirable to include information about three optional properties | |||
|
|||
### Software Citation Examples | |||
|
|||
[DSK: should we use a more common package as an example?] |
This comment has been minimized.
This comment has been minimized.
npch
Jan 13, 2020
Collaborator
That would be fine - I basically made up three fake pieces of software using the Loren Ipsum generator. I would want any software to be broadly recognised by everyone reading the software, and to make sure that the recommended citation for that software wasn't at odds with what would be here, which would lead to confusion.
This comment has been minimized.
This comment has been minimized.
Overall, this isn't really necessarily a PR but more feedback - feel free to close the PR and accept any of the comments you see as helpful by making changes directly to the document |
danielskatz commentedJan 10, 2020
No description provided.