Update documentation with up to date information

This commit is contained in:
Ethan Lane 2022-08-18 17:45:05 +01:00
parent ee4f1873d1
commit 57ab01c2cf
Signed by: Vylpes
GPG key ID: EED233CC06D12504
4 changed files with 36 additions and 25 deletions

View file

@ -61,7 +61,7 @@ representative at an online or offline event.
Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported to the community leaders responsible for enforcement at
[INSERT CONTACT METHOD].
[helpdesk@vylpes.com](mailto:helpdesk@vylpes.com).
All complaints will be reviewed and investigated promptly and fairly.
All community leaders are obligated to respect the privacy and security of the

View file

@ -14,6 +14,8 @@ This project and everyone participating in it is governed by the Random Bunny Co
You can ask a question about the project in the `#development` channel in the [Discord Server](https://discord.gg/UyAhAVp).
You can also email with queries and support if you'd prefer at [helpdesk@vylpes.com](mailto:helpdesk@vylpes.com).
## What you should know
### Javascript and Node
@ -115,13 +117,13 @@ You'll need the following tools:
* Git
* NodeJS
* Yarn
Install and build all of the dependencies using `npm`
```bash
cd Random Bunny
npm install
cp config.json.template config.json
cd random-bunny
yarn install
```
And then use your text editor of choice to fill in the `config.json` file.
@ -132,22 +134,20 @@ If you want to understand how Random Bunny works or want to debug an issue, you'
First, fork the Random Bunny repository so that you can make a pull request. Then, clone your fork locally:
```bash
git clone https://gitlab.vylpes.com/<your-gitlab-account>/random-bunny.git
git clone https://gitea.vylpes.xyz/<your-gitea-account>/random-bunny.git
```
Occasionally, you will want to merge changes in the upstream repository (the official code repo) with your fork.
```bash
cd Random Bunny
cd random-bunny
git checkout master
git pull https://gitlab.vylpes.com/vylpes/random-bunny.git master
git pull https://gitea.vylpes.xyz/vylpes/random-bunny.git master
```
Manage any merge conflicts, commit them, and then push them to your fork.
Go into `Random Bunny` and start the bot in dev mode with `npm run dev` or `node bot dev`
> **Note:** If you have `nodemon` installed on your system you can use this during development so it auto restarts when you make code changes. Instead of the commands above you can then run `nodemon bot dev`.
Go into `random-bunny` and build the package using `yarn build`.
#### Pull Requests
@ -169,6 +169,11 @@ Please follow these steps to have your contribution considered by maintainers:
While the prerequesites above must be satisifed prior to having your pull reuqest accepted, the reviewer(s) may ask you to complete additional design ork, tests, or other changes before your pull request can be ultimately accepted.
#### Submitting Changes via Email
If you're not within our gitea instance and still like to contribute, you can send us your contributions to [git@vylpes.com](mailto:git@vylpes.com).
For more information on how to do this, see the [git documentation](https://git-scm.com/docs/git-send-email).
#### JavaScript Styleguide
All JavaScript code is linted with `eslint`.
@ -309,21 +314,20 @@ Unsure where to begin contributing to Random Bunny? You can start by looking thr
#### Prerequisites
In order to download necessary tools, clone the repository, and install dependencies via `npm` you need network access.
In order to download necessary tools, clone the repository, and install dependencies via `yarn` you need network access.
You'll need the following tools:
* Git
* NodeJS
* Yarn
Install and build all of the dependencies using `npm`
Install and build all of the dependencies using `yarn`
```bash
cd Random Bunny
cd random-bunny
npm install
cp config.json.template config.json
```
And then use your text editor of choice to fill in the `config.json` file.
#### Build and Run
@ -332,22 +336,20 @@ If you want to understand how Random Bunny works or want to debug an issue, you'
First, fork the Random Bunny repository so that you can make a pull request. Then, clone your fork locally:
```bash
git clone https://gitlab.vylpes.com/<your-gitlab-account>/random-bunny.git
git clone https://gitea.vylpes.xyz/<your-gitea-account>/random-bunny.git
```
Occasionally, you will want to merge changes in the upstream repository (the official code repo) with your fork.
```bash
cd Random Bunny
cd random-bunny
git checkout master
git pull https://github.com/getgravitysoft/random-bunny.git master
git pull https://gitea.vylpes.xyz/RabbitLabs/random-bunny.git master
```
Manage any merge conflicts, commit them, and then push them to your fork.
Go into `Random Bunny` and start the bot in dev mode with `npm run dev` or `node bot dev`
> **Note:** If you have `nodemon` installed on your system you can use this during development so it auto restarts when you make code changes. Instead of the commands above you can then run `nodemon bot dev`.
Go into `random-bunny` and build the package using `yarn build`.
#### Pull Requests
@ -369,6 +371,11 @@ Please follow these steps to have your contribution considered by maintainers:
While the prerequesites above must be satisifed prior to having your pull reuqest accepted, the reviewer(s) may ask you to complete additional design ork, tests, or other changes before your pull request can be ultimately accepted.
#### Submitting Changes via Email
If you're not within our gitea instance and still like to contribute, you can send us your contributions to [git@vylpes.com](mailto:git@vylpes.com).
For more information on how to do this, see the [git documentation](https://git-scm.com/docs/git-send-email).
#### JavaScript Styleguide
All JavaScript code is linted with `eslint`.

View file

@ -1,6 +1,6 @@
{
"name": "random-bunny",
"version": "2.0.1",
"version": "2.0.2",
"description": "Get a random subreddit image url",
"license": "MIT",
"author": "Vylpes",
@ -26,8 +26,11 @@
"test": "echo none",
"lint": "eslint ."
},
"bugs": "https://github.com/Vylpes/random-bunny/issues",
"homepage": "https://github.com/Vylpes/random-bunny",
"bugs": {
"url": "https://gitea.vylpes.xyz/RabbitLabs/random-bunny/issues",
"email": "helpdesk@vylpes.com"
},
"homepage": "https://gitea.vylpes.xyz/RabbitLabs/random-bunny",
"funding": "https://ko-fi.com/vylpes",
"devDependencies": {
"@types/node": "^16.11.11",

View file

@ -53,7 +53,8 @@ The json string which gets returned consists of:
## Links
* Discord: [Server Link](https://vylpes.xyz/discord)
* Discord: [Server Link](https://discord.gg/UyAhAVp)
* Support: [helpdesk@vylpes.com](mailto:helpdesk@vylpes.com)
## License