From 5aaca643fa4a0bc939a0da1ecb51cc501692deb1 Mon Sep 17 00:00:00 2001
From: Joe Thorley <joe@poissonconsulting.ca>
Date: Fri, 3 Jan 2025 14:04:00 -0800
Subject: [PATCH] readme.Rmd

---
 .Rbuildignore |  1 +
 README.Rmd    | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++
 README.md     | 49 +++++++++++++++++++++++++++++++--------
 3 files changed, 103 insertions(+), 10 deletions(-)
 create mode 100644 README.Rmd

diff --git a/.Rbuildignore b/.Rbuildignore
index 05fdf20..0487210 100644
--- a/.Rbuildignore
+++ b/.Rbuildignore
@@ -5,3 +5,4 @@
 ^_pkgdown\.yml$
 ^docs$
 ^pkgdown$
+^README\.Rmd$
diff --git a/README.Rmd b/README.Rmd
new file mode 100644
index 0000000..a50614e
--- /dev/null
+++ b/README.Rmd
@@ -0,0 +1,63 @@
+---
+output: github_document
+---
+
+<!-- README.md is generated from README.Rmd. Please edit that file -->
+
+```{r, include = FALSE}
+knitr::opts_chunk$set(
+  collapse = TRUE,
+  comment = "#>",
+  fig.path = "man/figures/README-",
+  out.width = "100%"
+)
+```
+
+
+# poissontemplate
+
+<!-- badges: start -->
+[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable)
+[![R-CMD-check](https://github.com/poissonconsulting/poissontemplate/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/poissonconsulting/poissontemplate/actions/workflows/R-CMD-check.yaml)
+<!-- badges: end -->
+
+poissontemplate provides a custom [pkgdown](https://pkgdown.r-lib.org/) template for Poisson consulting packages. 
+Please don’t use it for your own package.
+
+## Setup
+
+In every package where you need to set up poissontemplate usage, run
+
+``` r
+poissontemplate::use_poisson_pkgdown()
+```
+
+## Installation
+
+### Release
+
+To install the release version from [CRAN](https://CRAN.R-project.org/package=poissontemplate).
+```r
+install.packages("poissontemplate")
+```
+
+The website for the release version is at <https://poissonconsulting.github.io/poissontemplate/>.
+
+### Development
+
+To install the development version from [r-universe](https://poissonconsulting.r-universe.dev/poissontemplate).
+```r
+install.packages("poissontemplate", repos = c("https://poissonconsulting.r-universe.dev", "https://cloud.r-project.org"))
+```
+
+or from [GitHub](https://github.com/poissonconsulting/poissontemplate)
+```r
+# install.packages("remotes")
+remotes::install_github("poissonconsulting/poissontemplate")
+```
+
+## Relevant resources
+
+- pkgdown documentation about theming: https://pkgdown.r-lib.org/articles/customise.html#theming
+- pkgdown documentation on template packages: https://pkgdown.r-lib.org/articles/customise.html#template-packages
+
diff --git a/README.md b/README.md
index 1dac20a..aae1113 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,60 @@
 
+<!-- README.md is generated from README.Rmd. Please edit that file -->
+
 # poissontemplate
 
 <!-- badges: start -->
+
+[![Lifecycle:
+stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable)
 [![R-CMD-check](https://github.com/poissonconsulting/poissontemplate/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/poissonconsulting/poissontemplate/actions/workflows/R-CMD-check.yaml)
 <!-- badges: end -->
 
-poissontemplate provides a custom [pkgdown](https://pkgdown.r-lib.org/) template for Poisson consulting packages. 
-Please don’t use it for your own package.
+poissontemplate provides a custom [pkgdown](https://pkgdown.r-lib.org/)
+template for Poisson consulting packages. Please don’t use it for your
+own package.
+
+## Setup
+
+In every package where you need to set up poissontemplate usage, run
+
+``` r
+poissontemplate::use_poisson_pkgdown()
+```
 
 ## Installation
 
-You can install the development version of poissontemplate from [GitHub](https://github.com/) with:
+### Release
+
+To install the release version from
+[CRAN](https://CRAN.R-project.org/package=poissontemplate).
 
 ``` r
-# install.packages("pak")
-pak::pak("poissonconsulting/poissontemplate")
+install.packages("poissontemplate")
 ```
 
-## Setup
+The website for the release version is at
+<https://poissonconsulting.github.io/poissontemplate/>.
 
-In every package where you need to set up poissontemplate usage, run
+### Development
+
+To install the development version from
+[r-universe](https://poissonconsulting.r-universe.dev/poissontemplate).
 
 ``` r
-poissontemplate::use_poisson_pkgdown()
+install.packages("poissontemplate", repos = c("https://poissonconsulting.r-universe.dev", "https://cloud.r-project.org"))
+```
+
+or from [GitHub](https://github.com/poissonconsulting/poissontemplate)
+
+``` r
+# install.packages("remotes")
+remotes::install_github("poissonconsulting/poissontemplate")
 ```
 
 ## Relevant resources
 
-- pkgdown documentation about theming: https://pkgdown.r-lib.org/articles/customise.html#theming
-- pkgdown documentation on template packages: https://pkgdown.r-lib.org/articles/customise.html#template-packages
+- pkgdown documentation about theming:
+  <https://pkgdown.r-lib.org/articles/customise.html#theming>
+- pkgdown documentation on template packages:
+  <https://pkgdown.r-lib.org/articles/customise.html#template-packages>