Skip to content
This repository has been archived by the owner on Apr 25, 2023. It is now read-only.

Latest commit

 

History

History
96 lines (58 loc) · 3.5 KB

CONTRIBUTING.md

File metadata and controls

96 lines (58 loc) · 3.5 KB
Raw

Contributing to 'rouge.js'

Support / Questions

For support or usage questions like "How do I do X with rouge." and "My code doesn't work.", please join our . telegram channel

Bugs

The ideal GitHub issue (and even some feature requests) is not an issue, it's a PR with a failing test case.
@rauchg

Before filing an issue please search the issue tracker; your issue may have already been discussed or fixed in master.

If you want your issue to get priority, submit it as a PR instead

Fill in the template provided by the issue tracker, try to be as clear and complete as possible, providing a Short, Self Contained, Correct (Compilable), Example (SSCE) (link to a repository) helps a lot .

Feature / Enhancement Requests

Feature or enhancement requests should be submitted in the issue tracker, with a description (follow the template) of the expected behavior & use case, where they’ll remain until approval by the lead maintainer(s) and/or enough interest from the community.

You can request a feature by writing a pull request, but this is no guarantee it will be merged.

Pull Requests (PR)

In general, the contribution workflow looks like this:

  1. Fork the repo.
  2. Clone the repo. git clone https://github.com/your-username/rouge.js.git.
  3. Create a new branch based off the master branch, provide a descriptive name
    (ex. 'feat-add-better-logging', 'bug-removed-double-method', 'enh-bumped-eslint')
  4. Before running the code you’ll need to install the dependencies (npm install or yarn).
  5. Implement your feature / bugfix (using the watch scripts), you should only need to modify /src. Don’t worry about regenerating the build folder /dist, it is built in the prepublish phase.
  6. Make sure all tests pass, coverage is 100% and there are no linting errors.
  7. Submit a PR, referencing what it addresses.
  8. Please try to keep your PR focused in scope and avoid including unrelated commits.

After you have submitted your PR, we'll try to get back to you as soon as possible.
We will review your PR and might request changes.

Development / Watch mode

You can run the watch scripts

npm run build:watch

and

npm run test:watch

to make development easier.

Coding Guidelines

Please follow the conventions already established in the code.

Guidelines are enforced using ESLint.

You can run the linting script by using

$ npm run lint

Testing

Include updated (or add new) tests in the __tests__/ directory as part of your PR.

You can run the test script by using

$ npm run test

or with coverage

$ npm run test:coverage

Aim for 100% coverage.

Hooks

We added pre-commit and pre-push hooks to make sure you don't commit non-working code.