diff --git a/README.Rmd b/README.Rmd
new file mode 100644
index 0000000..8637fb8
--- /dev/null
+++ b/README.Rmd
@@ -0,0 +1,23 @@
+---
+output: github_document
+---
+
+# targets R package design specification
+
+[![ropensci](https://badges.ropensci.org/401_status.svg)](https://github.com/ropensci/software-review/issues/401)
+[![JOSS](https://joss.theoj.org/papers/10.21105/joss.02959/status.svg)](https://doi.org/10.21105/joss.02959)
+[![status](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
+[![check](https://github.com/ropensci/targets-design/workflows/check/badge.svg)](https://github.com/ropensci/targets-design/actions?query=workflow%3Acheck)
+[![publish](https://github.com/ropensci/targets-design/workflows/publish/badge.svg)](https://github.com/ropensci/targets-design/actions?query=workflow%3Apublish)
+
+This repository contains the design specification of the [`targets`](https://github.com/ropensci/targets) R package. These specifications describe the internal architecture, the data storage model, and the orchestration and branching model. The goal is to help developers contribute to core elements of the package. The rendered output lives at <https://books.ropensci.org/targets-design>.
+
+## Code of conduct
+
+Please note that this package is released with a [Contributor Code of Conduct](https://ropensci.org/code-of-conduct/).
+
+## Citation
+
+```{r}
+citation("targets.design")
+```
diff --git a/README.md b/README.md
index 0db68fd..8aa9870 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # targets R package design specification
 
 [![ropensci](https://badges.ropensci.org/401_status.svg)](https://github.com/ropensci/software-review/issues/401)
-[![zenodo](https://zenodo.org/badge/273058618.svg)](https://zenodo.org/badge/latestdoi/273058618)
+[![JOSS](https://joss.theoj.org/papers/10.21105/joss.02959/status.svg)](https://doi.org/10.21105/joss.02959) 
 [![status](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
 [![check](https://github.com/ropensci/targets-design/workflows/check/badge.svg)](https://github.com/ropensci/targets-design/actions?query=workflow%3Acheck)
 [![publish](https://github.com/ropensci/targets-design/workflows/publish/badge.svg)](https://github.com/ropensci/targets-design/actions?query=workflow%3Apublish)