Skip to content

Latest commit

 

History

History
75 lines (47 loc) · 3.22 KB

CONTRIBUTING.md

File metadata and controls

75 lines (47 loc) · 3.22 KB
Raw

Report an Issue

Help us make ngx-metrika better! If you think you might have found a bug, or some other weirdness, start by making sure it hasn't already been reported. You can search through existing @kolkov/ngx-metrika issues to see if someone's reported one similar to yours.

If not, then create a plunkr that demonstrates the problem (try to use as little code as possible: the more minimalist, the faster we can debug it).

Next, create a new issue that briefly explains the problem, and provides a bit of background as to the circumstances that triggered it. Don't forget to include the link to that plunkr you created!

Note: If you're unsure how a feature is used, or are encountering some unexpected behavior that you aren't sure is a bug, it's best to talk it out on StackOverflow before reporting it. This keeps development streamlined, and helps us focus on building great software.

Issues only!
Please keep in mind that the issue tracker is for issues. Please do not post an issue if you need help or support. Instead, use StackOverflow.

Contribute

(1) See the Developing section below, to get the development version of ngx-metrika up and running on your local machine.

(2) Check out the roadmap to see where the project is headed, and if your feature idea fits with where we're headed.

(3) If you're not sure, open an RFC to get some feedback on your idea.

(4) Finally, commit some code and open a pull request. Code & commits should abide by the following rules:

  • Always have test coverage for new features (or regression tests for bug fixes), and never break existing tests
  • Commits should represent one logical change each; if a feature goes through multiple iterations, squash your commits down to one
  • Make sure to follow the Angular commit message format so your change will appear in the changelog of the next release.
  • Changes should always respect the coding style of the project

Developing

ngx-metrika uses Angular cli, npm and webpack.

Fetch the source code

The code for ngx-metrika is :

Clone repository.

mkdir ngx-metrika
cd ngx-metrika
git clone https://github.com/kolkov/ngx-metrika.git

Install dependencies

Use npm to install the development dependencies for the repository.

cd ngx-metrika
npm install

After executing these steps, your local copy of @kolkov/ngx-metrika-app will be built using your local copy of @kolkov/ngx-metrika instead of the prebuilt version specified in package.json.

Develop

  • npm run build:lib: Continuously builds the @kolkov/ngx-metrika` code when sources change.
  • npm run start: Continuously builds and runs Demo app when source or tests change.