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 <div style="display: flex; justify-content: space-around"> <div><img src="https://joss.theoj.org/assets/osi_small-d4948474b9fbc9c73e525cf2e4b287e6ff5ff640f73ef78d1056526ba0b1dccb.png"></div> <div><img src="https://joss.theoj.org/assets/numfocus-3d57edde83f2e692d53f2b46508ca0011c71ad44100fa9fb11604d5d038b3c9e.png"></div> </div> --- .pull-left-66[  ] .pull-right-33[ * Inclusive community * Code of conduct * Open process * Straightforward tooling * Assisted by @whedon ] --- # [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$$  ``` Inline math `\(\pi^2\)` as well as displayed math `$$\int_{-\infty}^{\infty} e^{ikx} f(x) \mathrm{d}x$$`  --- # 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 --- # https://joss.theoj.org/papers/new  --- # 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.  --- # Reviewers file issues with project .pull-left[  ] .pull-right[ * Discussion continues in review issue. * Rapid response cycle compared to traditional journals. * Reviewers eventually recommend acceptance.]  --- # Prizes for reviewers! .pull-left[] .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> ] ---  --- # JOSS is growing: pubs per month  --- # Geosciences editors .left-column[<img alt="Lindsey Heagy" src="https://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 ] --- # Sustainability 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](https://joss.theoj.org/reviewer-signup.html) * [Submit your research software to JOSS](https://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).]