Skip to content

Commit

Permalink
add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
mpadge committed Mar 20, 2024
1 parent d754110 commit 3be08d1
Show file tree
Hide file tree
Showing 3 changed files with 32 additions and 2 deletions.
2 changes: 1 addition & 1 deletion DESCRIPTION
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Package: dashboard
Title: What the Package Does (One Line, Title Case)
Version: 0.0.10.008
Version: 0.0.11
Authors@R:
person(given = "First",
family = "Last",
Expand Down
30 changes: 30 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@

# rOpenSci Software Review Dashboard

This repository contains the source code for [rOpenSci's *Software Review
Dashboard*](https://ropensci-review-tools.github.io/dashboard). This includes
both a local R package named "dashboard", and a [quarto
directory](https://github.com/ropensci-review-tools/dashboard/tree/main/quarto)
which includes the source files for the website. This README is intended only
for developers. Anybody solely interested in the dashboard should [head
straight to the website](https://ropensci-review-tools.github.io/dashboard).

## renv and local usage

The quarto website uses [`renv`](https://rstudio.github.io/renv/) to manage
package dependencies in the [GitHub
workflow](https://github.com/ropensci-review-tools/dashboard/blob/main/.github/workflows/publish.yaml).
The environment will be automatically built the first time R is started in the
root directory of this repository. This environment will nevertheless not
include the package itself, and so the package needs to be manually installed
using:

``` r
remotes::install_github ("ropensci-review-tools/dashboard")
```

The website can be locally previewed by running `quarto preview` in the
`quarto` directory, using the locally-installed version of the "dashboard"
package. This means that any updates to the package itself will only be
rendered on the quarto website once those changes have been pushed and the
package locally re-installed using the `install_github` command above.
2 changes: 1 addition & 1 deletion codemeta.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"name": "dashboard: What the Package Does (One Line, Title Case)",
"codeRepository": "https://github.com/ropensci-review-tools/dashboard",
"license": "https://spdx.org/licenses/MIT",
"version": "0.0.10.008",
"version": "0.0.11",
"programmingLanguage": {
"@type": "ComputerLanguage",
"name": "R",
Expand Down

0 comments on commit 3be08d1

Please sign in to comment.