JOSS: the Journal of Open Source Software

background-image: url(https://raw.githubusercontent.com/openjournals/digital-assets/master/joss/logo/JOSS_banner_1200x446.png)
background-size: auto 50%
background-position: top
class: center, bottom

## Journal of Open Source Software
### Jed Brown, CU Boulder
### CSDMS, 2019-05-21

---
# What is JOSS?

### Citations are academic currency
* Research can be effectively disseminated via software
* What should be cited?
  - Web page? 10-year old methods paper? User's manual?

### JOSS: peer review for research software
* ISSN 2475-9066, CrossRef DOI
* Open, constructive review
* Developer friendly

---
![JOSS review process](figures/JOSS-flowchart.svg)
---
# [Submitting to JOSS](https://joss.readthedocs.io/en/latest/submitting.html)

* The software should be **open source** as per the [OSI definition](https://opensource.org/osd)
* The software should have an **obvious research application**
* You should be a **major contributor** to the software you are submitting
* The software should be a **significant contribution** to the available open source software that either enables some new research challenges to be addressed or makes addressing research challenges significantly better (e.g., faster, easier, simpler)
* The software should be **feature complete** (no half-baked solutions) and designed for maintainable extension (not one-off modifications). Minor ‘utility’ packages, including ‘thin’ API clients, are not acceptable.

Also, available in a public repository, open issue tracker, accepting contributions.

---
# Write a JOSS paper: metadata
```yaml
title: 'Lithology: A Landlab submodule for spatially variable rock properties'
tags:
  - Python
  - Landlab
authors:
  - name: Katherine R. Barnhart
    orcid: 0000-0001-5682-455X
    affiliation: 1, 2
```
```yaml
affiliations:
  - name: University of Colorado at Boulder, Department of Geological Sciences
    index: 1
```
```yaml
date: 16 August 2018
bibliography: papers.bib
---
```

---
# Write a JOSS paper: content
```markdown
# Summary

The surface of the Earth reflects the competing advection of rock by tectonic
processes and the erosion of rock by wind, water, and ice. Rock properties
influence erosion rates by changing the processes responsible for erosion and
the rate at which rock is weathered, detached, and turned into mobile sediment.
Variations in the rock properties over space and with depth reflect the legacy
of sedimentary deposition and tectonic deformation. Long-term landscape
evolution modeling experiments that include the impact of spatially and
temporally variable rock characteristics can be used to identify the impact of
rock strength patterns on other geologic observables such as topography, erosion
rates, and detrital mineral records [e.g., @Forte2016Complexites;
@Perne2017Steady]. Identifying these relationships allows for better
interpretations of the geologic record.
```
* [Rmarkdown-style citations](https://rmarkdown.rstudio.com/authoring_bibliographies_and_citations.html#citation_syntax)

---
# Write a JOSS paper: Pandoc Markdown
```
Inline math $\pi^2$ as well as displayed math
$$\int_{-\infty}^{\infty} e^{ikx} f(x) \mathrm{d}x$$

![Images with captions](https://github.com/openjournals/digital-assets/raw/master/joss/logo/JOSS_100x100.png)
```

Inline math `$\pi^2$` as well as displayed math
`$$\int_{-\infty}^{\infty} e^{ikx} f(x) \mathrm{d}x$$`
![Images with captions](https://github.com/openjournals/digital-assets/raw/master/joss/logo/JOSS_100x100.png)

---
# What goes in the paper?

* Papers are short: typically 1-3 pages
  - Do not duplicate software/API documentation
  - Not a detailed methods paper

* What research problem does your software solve?
* What other software is relevant to these problems?
* Strive to help a prospective user choose appropriate software.
* Cite important papers describing methodology
* Cite key software dependencies

---
# http://joss.theoj.org/papers/new

![Submission Lithology](figures/joss-lithology.png){width=80%}

---
# JOSS reviews are **constructive**

The goal is to **improve** the quality of the research software, not to make accept/reject decisions.

The review process is **open**.

Packages that follow best practices can be accepted quickly.  Other packages may need a lot of work.

![JOSS author praise](figures/joss-author-praise.png)
---
# Reviewers file issues with project

.pull-left[
![Issue filed](figures/joss-lithology-issue.png)
]
.pull-right[
* Discussion continues in review issue.
* Rapid response cycle compared to traditional journals.
* Reviewers eventually recommend acceptance.]
![Recommend acceptance](figures/joss-lithology-review-accept.png)

---
# Prizes for reviewers!
.pull-left[![JOSS Hoody](https://pbs.twimg.com/media/D6he8r_XkAA8KJc.png)]
.pull-right[
<blockquote class="twitter-tweet" data-lang="en"><p lang="en" dir="ltr">A special thanks to our most dedicated reviewers 🙏—<a href="https://twitter.com/brycem?ref_src=twsrc%5Etfw">@brycem</a> and <a href="https://twitter.com/luizirber?ref_src=twsrc%5Etfw">@luizirber</a> have each contributed 9 reviews to <a href="https://twitter.com/hashtag/JOSS_theOJ?src=hash&amp;ref_src=twsrc%5Etfw">#JOSS_theOJ</a>, and they get a hoodie! <a href="https://t.co/ll5cwozWQw">https://t.co/ll5cwozWQw</a> <a href="https://t.co/Ow45DqknWN">pic.twitter.com/Ow45DqknWN</a></p>&mdash; Lorena Barba (@LorenaABarba) <a href="https://twitter.com/LorenaABarba/status/1128256109486268416?ref_src=twsrc%5Etfw">May 14, 2019</a></blockquote>
<script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
]

---
![Accepted](figures/joss-lithology-accepted.png)
---
# JOSS is growing: pubs per month
![Publications by month](figures/joss-pubs-by-month.png)
---
# Geosciences editors

.left-column[<img alt="Lindsey Heagy" src="http://joss.theoj.org/assets/editors/lindsey-9486824dd0a77fdbc4933a72f758a9d2d1e5358a7a6d16990e2680d22d7cd1fa.png", style="height: 160px">
<img alt="Kristen Thyng" src="https://raw.githubusercontent.com/openjournals/joss/master/app/assets/images/editors/kristen.jpg", style="height: 160px">
<img alt="Leonardo Uieda" src="https://raw.githubusercontent.com/openjournals/joss/ba65db855e0e45b0aa26b04b53fca11ea20b96fa/app/assets/images/editors/leonardo.jpg" style="height: 160px">
]
.right-column[
### [Lindsey Heagy (@lheagy)](http://lindseyjh.ca/)
Editor: Geoscience, geophysics

### [Kristen Thyng (@kthyng)](http://kristenthyng.com/)
Editor: computational fluid dynamics, oceanography, geosciences

### [Leonardo Uieda (@leouieda)](https://www.leouieda.com/)
Editor: Geoscience, Geophysics, Data Visualization
]

---
# Business Model

JOSS is an open-access journal **committed to running at minimal
costs, with zero publication fees (article processing charges)
or subscription fees**. With volunteer effort from our editorial board,
community reviewers, donations, and minimal infrastructure costs we be-
lieve JOSS can remain a free community service.

Operating costs:
* Annual Crossref membership: $275 / year
* JOSS paper DOIs: $1 / accepted paper
* JOSS website hosting (Heroku): $19 / month

Cost per paper: $3.50 (assuming 200 papers per year)

---
# Get Involved!

* [Volunteer to review for JOSS](http://joss.theoj.org/reviewer-signup.html)
* [Submit your research software to JOSS](http://joss.theoj.org/papers/new)
* Accurately cite software (whether or not it is in JOSS)

--
# Questions?

.footnote[Slides created via the R package [**xaringan**](https://github.com/yihui/xaringan).]