Skip to content

Commit

Permalink
update readmes and description
Browse files Browse the repository at this point in the history
  • Loading branch information
m7pr committed Sep 11, 2023
1 parent d968458 commit e9fc0bc
Show file tree
Hide file tree
Showing 11 changed files with 51 additions and 24 deletions.
1 change: 1 addition & 0 deletions .Rbuildignore
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
LICENSE
^renv$
^renv\.lock$
CODE_OF_CONDUCT.md
Expand Down
12 changes: 6 additions & 6 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,17 +94,17 @@ This repository follows the standard [`tidyverse` style guide](https://style.tid

### Dependency management

Lightweight is the right weight. This repository follows [tinyverse](https://www.tinyverse.org/) recommedations of limiting dependencies to minimum.
Lightweight is the right weight. This repository follows [tinyverse](https://www.tinyverse.org/) recommendations of limiting dependencies to minimum.

### Dependency version management

If the code is not compatible with all (!) historical versions of a given dependenct package, it is required to specify minimal version in the `DESCRIPTION` file. In particular: if the development version requires (imports) the development version of another package - it is required to put `abc (>= 1.2.3.9000)`.
If the code is not compatible with all (!) historical versions of a given dependency package, it is required to specify minimal version in the `DESCRIPTION` file. In particular: if the development version requires (imports) the development version of another package - it is required to put `abc (>= 1.2.3.9000)`.

### Recommended development environment & tools

#### R & package versions

We continuously test our packages against the newest R version along with the most recent dependencies from CRAN and BioConductor. We recommend that your working environment is also set up in the same way. You can find the details about the R version and packages used in the `R CMD check` GitHub Action execution log - there is a step that prints out the R `sessionInfo()`.
We continuously test our packages against the newest R version along with the most recent dependencies from CRAN and `BioConductor`. We recommend that your working environment is also set up in the same way. You can find the details about the R version and packages used in the `R CMD check` GitHub Action execution log - there is a step that prints out the R `sessionInfo()`.

If you discover bugs on older R versions or with an older set of dependencies, please create the relevant bug reports.

Expand All @@ -130,7 +130,7 @@ The package maintainer also reserves the right to adjust the criteria to recogni
If you have further questions regarding the contribution guidelines, please contact the package/repository maintainer.

<!-- urls -->
[docs]: https://insightsengineering.github.io/teal.slice/index.html
[articles]: https://insightsengineering.github.io/teal.slice/main/articles/index.html
[license]: https://insightsengineering.github.io/teal.slice/main/LICENSE-text.html
[docs]: https://insightsengineering.github.io/teal.slice/latest-tag/index.html
[articles]: https://insightsengineering.github.io/teal.slice/latest-tag/articles/index.html
[license]: https://insightsengineering.github.io/teal.slice/latest-tag/LICENSE-text.html
[insights]: https://github.com/insightsengineering/teal.slice/pulse
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/bug.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,15 +33,15 @@ body:
id: code-of-conduct
attributes:
label: Code of Conduct
description: By submitting this issue, you agree to follow our [Code of Conduct.](https://insightsengineering.github.io/teal.slice/CODE_OF_CONDUCT.html)
description: By submitting this issue, you agree to follow our [Code of Conduct.](https://insightsengineering.github.io/teal.slice/latest-tag/CODE_OF_CONDUCT.html)
options:
- label: I agree to follow this project's Code of Conduct.
required: true
- type: checkboxes
id: contributor-guidelines
attributes:
label: Contribution Guidelines
description: By submitting this issue, you agree to follow our [Contribution Guidelines.](https://insightsengineering.github.io/teal.slice/CONTRIBUTING.html)
description: By submitting this issue, you agree to follow our [Contribution Guidelines.](https://insightsengineering.github.io/teal.slice/latest-tag/CONTRIBUTING.html)
options:
- label: I agree to follow this project's Contribution Guidelines.
required: true
Expand Down
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/feature.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,15 +13,15 @@ body:
id: code-of-conduct
attributes:
label: Code of Conduct
description: By submitting this issue, you agree to follow our [Code of Conduct.](https://insightsengineering.github.io/teal.slice/CODE_OF_CONDUCT.html)
description: By submitting this issue, you agree to follow our [Code of Conduct.](https://insightsengineering.github.io/teal.slice/latest-tag/CODE_OF_CONDUCT.html)
options:
- label: I agree to follow this project's Code of Conduct.
required: true
- type: checkboxes
id: contributor-guidelines
attributes:
label: Contribution Guidelines
description: By submitting this issue, you agree to follow our [Contribution Guidelines.](https://insightsengineering.github.io/teal.slice/CONTRIBUTING.html)
description: By submitting this issue, you agree to follow our [Contribution Guidelines.](https://insightsengineering.github.io/teal.slice/latest-tag/CONTRIBUTING.html)
options:
- label: I agree to follow this project's Contribution Guidelines.
required: true
Expand Down
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/question.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,15 +13,15 @@ body:
id: code-of-conduct
attributes:
label: Code of Conduct
description: By submitting this issue, you agree to follow our [Code of Conduct.](https://insightsengineering.github.io/teal.slice/CODE_OF_CONDUCT.html)
description: By submitting this issue, you agree to follow our [Code of Conduct.](https://insightsengineering.github.io/teal.slice/latest-tag/CODE_OF_CONDUCT.html)
options:
- label: I agree to follow this project's Code of Conduct.
required: true
- type: checkboxes
id: contributor-guidelines
attributes:
label: Contribution Guidelines
description: By submitting this issue, you agree to follow our [Contribution Guidelines.](https://insightsengineering.github.io/teal.slice/CONTRIBUTING.html)
description: By submitting this issue, you agree to follow our [Contribution Guidelines.](https://insightsengineering.github.io/teal.slice/latest-tag/CONTRIBUTING.html)
options:
- label: I agree to follow this project's Contribution Guidelines.
required: true
Expand Down
11 changes: 8 additions & 3 deletions DESCRIPTION
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Type: Package
Package: teal.slice
Title: Filter Module for `teal` Applications
Title: Filter Module for 'teal' Applications
Version: 0.4.0.9012
Date: 2023-09-08
Authors@R: c(
Expand All @@ -19,8 +19,13 @@ Authors@R: c(
person("Junlue", "Zhao", role = "aut"),
person("F. Hoffmann-La Roche AG", role = c("cph", "fnd"))
)
Description: Filter module for teal applications.
License: Apache License 2.0 | file LICENSE
Description:
Module containing filter panel for 'teal' applications. Allows for interactive filtering of data stored in
'data.frame' and 'MultiAssayExperiment' objects. Also displays filtered and unfiltered observation counts.
License: Apache License 2.0
URL: https://insightsengineering.github.io/teal.slice/,
https://github.com/insightsengineering/teal.slice/
BugReports: https://github.com/insightsengineering/teal.slice/issues
Depends:
R (>= 4.0),
shiny
Expand Down
20 changes: 17 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,17 +27,31 @@

## Installation

From July 2023 `insightsengineering` packages are available on [r-universe](https://r-universe.dev/).

```r
# stable versions
install.packages('teal.slice', repos = c('https://insightsengineering.r-universe.dev', 'https://cloud.r-project.org'))

# install.packages("pak")
pak::pak("insightsengineering/teal.slice@*release")
```

Alternatively, you might want to use the development version available on [r-universe](https://r-universe.dev/).

```r
# beta versions
install.packages('teal.slice', repos = c('https://pharmaverse.r-universe.dev', 'https://cloud.r-project.org'))

# install.packages("pak")
pak::pak("insightsengineering/teal.slice")
```

See package vignettes `browseVignettes(package = "teal.slice")` for usage of this package.
## Usage

To understand how to use this package, please refer to the [Introduction to teal.slice](https://insightsengineering.github.io/teal.slice/latest-tag/articles/teal-slice.html) article, which provides multiple examples of code implementation.

## Getting help

If you encounter a bug or you have a feature request - please file an issue. For questions, discussions and staying up to date, please use the "teal" channel in the [`pharmaverse` slack workspace](https://pharmaverse.slack.com).

## Stargazers and Forkers

Expand Down
16 changes: 13 additions & 3 deletions inst/WORDLIST
Original file line number Diff line number Diff line change
@@ -1,10 +1,20 @@
Forkers
Hoffmann
UI
cloneable
Forkers
funder
github
Hoffmann
https
insightsengineering
io
Pre
programmatically
repo
reproducibility
sessionInfo
subclasses
subtype
textarea
tinyverse
UI
upvote
sessionInfo
1 change: 0 additions & 1 deletion vignettes/filter-panel-for-developers.Rmd
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
---
title: "Filter panel for developers"
author: "NEST Core Dev Team"
date: "10/07/2023"
output: rmarkdown::html_vignette
vignette: >
%\VignetteIndexEntry{Filter panel for developers}
Expand Down
1 change: 0 additions & 1 deletion vignettes/teal-slice-classes.Rmd
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
---
title: "teal.slice classes"
author: "NEST Core Dev Team"
date: "10/07/2023"
output:
rmarkdown::html_vignette:
toc: true
Expand Down
1 change: 0 additions & 1 deletion vignettes/teal-slice.Rmd
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
---
title: "Introduction to teal.slice"
author: "NEST Core Dev Team"
date: "01/07/2022"
output:
rmarkdown::html_vignette:
toc: true
Expand Down

0 comments on commit e9fc0bc

Please sign in to comment.