https://github.com/andreww/publishing_your_code
Some notes and resources to help take software from a research project to a research software publication
Science Score: 46.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
✓Academic publication links
Links to: joss.theoj.org -
✓Committers with academic emails
1 of 1 committers (100.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.9%) to scientific vocabulary
Repository
Some notes and resources to help take software from a research project to a research software publication
Basic Info
- Host: GitHub
- Owner: andreww
- License: other
- Default Branch: master
- Size: 18.6 KB
Statistics
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
Publishing Your Code
Many researchers will produce software as part of their research and, in order to gain recognition of the work involved in this, as well as to enable reuse, it can be beneficial to formally publish this software. This repository contains a collection of notes and resources to help researchers publish software for the first time. The material may eventually form the basis of a short course or workshop.
Target, aims, and objectives
There are many potential venues for the publication of research software and many who may benifit from publishing their software. Software can be made available online in multiple ways and described within theses, in conference proceedings, or alongside the research results. Here I focus on the researcher who has developed software for the first time, has probably generated some scientific insight using that software, and is now ready to prepare the software for wider dissemination. In particular, I imagine publication in the the Journal of Open Source Software, but the process of preparing for publication there will also cover most other targets. More importantly, the process of preparing the first peice of research software for publication should provide valuable lessons for the development of future software. Applying these lessons should make it easer develop and share software in future.
Reviewing for JOSS involves judging submitted software against a short checklist and criteria but rather than stucture the material here around these lists I have attempted to arrange things in an order that makes sense for a first time developer rather than a reviewer (who is likly to be a more experianced developer). My hope is that if somebody works through the material in the order presented here they will be in a position to publish their software, to act as a reviewer for software publications, and that the order that material is presented follows a logical path.
Content
- What's interesting about your software?
- A stand-alone package or part of something else?
- Version control: getting organised.
- Applying a software license.
- Got any tests?
- Types of documentation.
- Using version control to work with others.
- Reviewing your code
- Automating tests and running them regularly.
- Documenting installation and use.
- Where are the gremlins.
This work by Andrew Walker is licensed under a Creative Commons Attribution 4.0 International License.
Owner
- Name: Andrew Walker
- Login: andreww
- Kind: user
- Website: http://homepages.see.leeds.ac.uk/~earawa/
- Repositories: 81
- Profile: https://github.com/andreww
GitHub Events
Total
- Watch event: 1
Last Year
- Watch event: 1
Committers
Last synced: 9 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Andrew Walker | a****r@l****k | 10 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 9 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0