From e2f455d7bdb72965c2ae83ed2929040d0b22cc4e Mon Sep 17 00:00:00 2001 From: LuanRT Date: Mon, 18 Jul 2022 04:36:21 -0300 Subject: [PATCH] chore(docs): add contribution guidelines file --- CONTRIBUTING.md | 103 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..fe4fce3e --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,103 @@ +# Contributing to YouTube.js + +Thank you for taking the time to contribute! +The following is a set of guidelines for contributing to YouTube.js. +___ +* [Issues](#issues) + * [Create a new issue](#issue-1) + * [Solve an issue](#issue-2) + +* [Make changes](#changes) + * [Commit your updates](#changes-1) + * [Create a PR](#changes-2) + * [Run tests](#test) + * [Lint your code](#lint) + * [Build for node](#build-1) + * [Bundle for browsers](#build-2) + * [Compile proto file](#build-3) + * [Build parser map](#build-4) + +## Issues + + +#### Create a new issue +If you find a problem, search if an issue already exists. If a related issue doesn't exist, you can open a new issue using a relevant issue form. + + +#### Solve an issue +Scan through the existing issues to find one that interests you. You can narrow down the search using labels as filters. If you find an issue to work on, you are welcome to open a PR with a fix. + + +## Make changes + +1. Fork the repository +2. Install or update to **Node.js v16** +3. Create a working branch and start with your changes! + + +#### Commit your updates + +Commit the changes once you're happy with them. + + +#### Pull Request + +When you think the code is ready for review a pull request should be created on Github. Owners of the repository will watch out for new PR‘s and review them in regular intervals. + +- Fill the template. +- Link the PR to an issue, if you are solving one. +- Enable the checkbox to allow maintainer edits so the branch can be updated for a merge. +- Changes may be requested before a PR can be merged. +- As you update your PR and apply changes, mark each conversation as resolved. + + +#### Test + +```bash +npm run test +``` + + +#### Lint + +```bash +npm run lint +``` + +Or + +```bash +npm run lint:fix +``` + + +#### Build for Node + +```bash +npm run build:node +``` + + +#### Build for browsers + +```bash +npm run build:browser +``` +Or: +```bash +npm run build:browser:prod +``` + + +#### Compile proto file + +```bash +// TODO +``` + + +#### Build parser map + +```bash +npm run build:parser-map +```