-
Notifications
You must be signed in to change notification settings - Fork 21
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
539 changed files
with
67,811 additions
and
2,272 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -5,3 +5,7 @@ | |
README.md | ||
^\.github$ | ||
^LICENSE\.md$ | ||
^_pkgdown\.yml$ | ||
^docs$ | ||
^pkgdown$ | ||
^codemeta\.json$ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
# Workflow derived from https://github.com/r-lib/actions/tree/master/examples | ||
# Need help debugging build failures? Start at https://github.com/r-lib/actions#where-to-find-help | ||
on: | ||
push: | ||
branches: [main, master] | ||
release: | ||
types: [published] | ||
workflow_dispatch: | ||
|
||
name: pkgdown | ||
|
||
jobs: | ||
pkgdown: | ||
runs-on: ubuntu-latest | ||
env: | ||
GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }} | ||
steps: | ||
- uses: actions/checkout@v2 | ||
|
||
- uses: r-lib/actions/setup-pandoc@v1 | ||
|
||
- uses: r-lib/actions/setup-r@v1 | ||
with: | ||
use-public-rspm: true | ||
|
||
- uses: r-lib/actions/setup-r-dependencies@v1 | ||
with: | ||
extra-packages: pkgdown | ||
needs: website | ||
|
||
- name: Deploy package | ||
run: | | ||
git config --local user.name "$GITHUB_ACTOR" | ||
git config --local user.email "$GITHUB_ACTOR@users.noreply.github.com" | ||
Rscript -e 'pkgdown::deploy_to_branch(new_process = FALSE)' |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -9,3 +9,5 @@ dartR.Rproj | |
dartR.Rproj | ||
/doc/ | ||
/Meta/ | ||
docs | ||
.RDataTmp |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,93 @@ | ||
# Contributing to dartR | ||
|
||
<!-- This CONTRIBUTING.md is adapted from https://gist.github.com/peterdesmet/e90a1b0dc17af6c12daf6e8b2f044e7c --> | ||
|
||
First of all, thanks for considering contributing to dartR! 👍 It's people like you that make it rewarding for us - the project maintainers - to work on dartR. 😊 | ||
|
||
dartR is an open source project, maintained by people who care. | ||
|
||
[repo]: https://github.com/green-striped-gecko/dartR | ||
[issues]: https://github.com/green-striped-gecko/dartR/issues | ||
[new_issue]: https://github.com/green-striped-gecko/dartR/issues/new | ||
[website]: https://green-striped-gecko.github.io/dartR/ | ||
[email]: mailto:Bernd.Gruber@canberra.edu.au | ||
[google]: https://groups.google.com/g/dartr?pli=1 | ||
[developer]: http://georges.biomatix.org/storage/app/media/uploaded-files/Tutorial_0_dartR_for_the_Developer_2.0_19-Feb-22.pdf | ||
|
||
## Code of conduct | ||
|
||
Please note that this project is released with a [Contributor Code of Conduct](code_of_conduct.md). By participating in this project you agree to abide by its terms. | ||
|
||
## How you can contribute | ||
|
||
There are several ways you can contribute to this project. If you want to know more about why and how to contribute to open source projects like this one, see this [Open Source Guide](https://opensource.guide/how-to-contribute/). | ||
|
||
We have prepared a [document][developer] describing how independent developers can contribute to dartR. This document explains the structure of the functions in dartR, programming style, the data structure of the genlight object used in dartR, workflow and many other topics. | ||
|
||
### Share the love ❤️ | ||
|
||
Think dartR is useful? Let others discover it, by telling them in person, via Twitter or a blog post. | ||
|
||
If you use dartR in your research, please support us by citing dartR. You can find the citation information by typing in the R console: | ||
|
||
```{r}I | ||
citation("dartR”) | ||
``` | ||
|
||
### Ask a question ⁉️ | ||
|
||
Using dartR and got stuck? Browse the [documentation][website] to see if you can find a solution. Still stuck? Post your question in our [Google groups forum][new_issue] and we'll try to do our best to address it. | ||
|
||
Want to ask a question in private? Contact the package maintainer by [email][mailto:email]. | ||
|
||
### Propose an idea 💡 | ||
|
||
Have an idea for a new dartR feature? Take a look at the [documentation][website] and [issue list][issues] to see if it isn't included or suggested yet. If not, suggest your idea as an [issue on GitHub][new_issue]. While we can't promise to implement your idea, it helps to: | ||
|
||
* Explain in detail how it would work. | ||
* Keep the scope as narrow as possible. | ||
|
||
See below if you want to contribute code for your idea as well. | ||
|
||
### Report a bug 🐛 | ||
|
||
Using dartR and discovered a bug? That's annoying! Don't let others have the same experience and report it as an [issue on GitHub][new_issue] so we can fix it. A good bug report makes it easier for us to do so, so please include: | ||
|
||
* Your operating system name and version (e.g. Mac OS 10.13.6). | ||
* Any details about your local setup that might be helpful in troubleshooting. | ||
* Detailed steps to reproduce the bug. | ||
|
||
### Improve the documentation 📖 | ||
|
||
Noticed a typo on the website? Think a function could use a better example? Good documentation makes all the difference, so your help to improve it is very welcome! | ||
|
||
#### The website | ||
|
||
[This website][website] is generated with [`pkgdown`](http://pkgdown.r-lib.org/). That means we don't have to write any html: content is pulled together from documentation in the code, vignettes, [Markdown](https://guides.github.com/features/mastering-markdown/) files, the package `DESCRIPTION` and `_pkgdown.yml` settings. If you know your way around `pkgdown`, you can [propose a file change](https://help.github.com/articles/editing-files-in-another-user-s-repository/) to improve documentation. If not, [report an issue][new_issue] and we can point you in the right direction. | ||
|
||
#### Function documentation | ||
|
||
Functions are described as comments near their code and translated to documentation using [`roxygen2`](https://klutometis.github.io/roxygen/). If you want to improve a function description: | ||
|
||
1. Go to `R/` directory in the [code repository][repo]. | ||
2. Look for the file with the name of the function. | ||
3. [Propose a file change](https://help.github.com/articles/editing-files-in-another-user-s-repository/) to update the function documentation in the roxygen comments (starting with `#'`). | ||
|
||
### Contribute code 📝 | ||
|
||
Care to fix bugs or implement new functionality for dartR? Awesome! 👏 Have a look at the [issue list][issues] and leave a comment on the things you want to work on. See also the development guidelines below. | ||
|
||
## Development guidelines | ||
|
||
We try to follow the [GitHub flow](https://guides.github.com/introduction/flow/) for development. | ||
|
||
1. Fork [this repo][repo] and clone it to your computer. To learn more about this process, see [this guide](https://guides.github.com/activities/forking/). | ||
2. If you have forked and cloned the project before and it has been a while since you worked on it, [pull changes from the original repo](https://help.github.com/articles/merging-an-upstream-repository-into-your-fork/) to your clone by using `git pull upstream master`. | ||
3. Open the RStudio project file (`.Rproj`). | ||
4. Make your changes: | ||
* Write your code. | ||
* Test your code (bonus points for adding unit tests). | ||
* Document your code (see function documentation above). | ||
* Check your code with `devtools::check()` and aim for 0 errors and warnings. | ||
5. Commit and push your changes. | ||
6. Submit a [pull request](https://guides.github.com/activities/forking/#making-a-pull-request). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.