Skip to content

Commit c007701

Browse files
committed
more readme
1 parent 27d1b11 commit c007701

File tree

3 files changed

+40
-2
lines changed

3 files changed

+40
-2
lines changed

DESCRIPTION

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Package: repometrics
22
Title: Metrics for Your Code Repository
3-
Version: 0.1.3.018
3+
Version: 0.1.3.019
44
Authors@R:
55
person("Mark", "Padgham", , "mark.padgham@email.com", role = c("aut", "cre"),
66
comment = c(ORCID = "0000-0003-2172-5265"))

README.md

+38
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,44 @@ from commit histories and GitHub interactions, converts it all to standardised
1414
metrics, and displays the result as a single, interactive dashboard of your
1515
repository.
1616

17+
## How?
18+
19+
### Installation
20+
21+
First, install the package either via [`r-universe`](https://r-universe.dev):
22+
23+
``` r
24+
options (repos = c (
25+
ropenscireviewtools = "https://ropensci-review-tools.r-universe.dev",
26+
CRAN = "https://cloud.r-project.org"
27+
))
28+
install.packages ("repometrics")
29+
```
30+
or directly from GitHub with one of these two lines:
31+
32+
``` r
33+
remotes::install_github ("ropensci-review-tools/repometrics")
34+
pak::pkg_install ("ropensci-review-tools/repometrics")
35+
```
36+
37+
### Use
38+
39+
The main data-gathering function requires just one parameter specifying the
40+
path to a local source repository:
41+
42+
``` r
43+
data <- repometrics_data_pkg (path)
44+
```
45+
46+
The results can then be visualised as an interactive dashboard by running this
47+
line:
48+
49+
``` r
50+
repometrics_dashboard (data)
51+
```
52+
53+
The dashboard will automatically open in your default browser.
54+
1755
## Prior Art
1856

1957
There are lots of tools for collating metrics of software repositories, most of

codemeta.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
"codeRepository": "https://github.com/ropensci-review-tools/repometrics",
99
"issueTracker": "https://github.com/ropensci-review-tools/repometrics/issues",
1010
"license": "https://spdx.org/licenses/GPL-3.0",
11-
"version": "0.1.3.018",
11+
"version": "0.1.3.019",
1212
"programmingLanguage": {
1313
"@type": "ComputerLanguage",
1414
"name": "R",

0 commit comments

Comments
 (0)