Hopiu/vue-material
1
0
Fork 0
mirror of https://github.com/Hopiu/vue-material.git synced 2026-03-17 06:20:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
vue-material/.github/CONTRIBUTING.md
Marcos Moura 905bc02d94 add Gitter Channel
2017-01-12 19:26:12 -02:00

2.5 KiB
Raw Permalink Blame History

Vue Material Contributing Guide

Before submitting your contribution please read the guidelines.

Issue Reporting Guidelines

  • Do not create questions. The issue list is exclusively for reports, bugs and feature requests. Use the Gitter Channel instead.

  • Always search for your issue first. It may have already been answered, planned or fixed in some branch. New components and features will be planned on Milestones or on Projects.

  • Only create issues for the newest version. For now. Until 1.0.0.

  • Create a declarative title and describe clearly the steps necessary to reproduce the issue. If an issue labeled "need repro" receives no further input from the issue author for more than 3 days, it will be closed.

  • If you want to show your code please use Codepen or JSFiddle. You could start with this template.

  • In case you found a solution by yourself try to explain how you fixed it. It could be useful for somebody else. :)

Pull Request Guidelines

  • The master branch is basically just a snapshot of the latest stable release. All development should be done in dedicated branches. Do not submit PRs against the master branch.

  • Work in the src or docs folder and DO NOT add dist in the commits.

  • Make small commits as you work on the PR. They will be automatically squashed before merging.

  • Provide convincing reason to add a new feature. Ideally you should open a suggestion/request issue first and have it greenlighted before working on it.

  • If fixing a bug:

    • If you are resolving a special issue, add the GitHub ID to your commit. E.g. (fix something really ugly #xxx)
    • Provide detailed description of the bug in the PR.

Development Setup

You will need Node.js version 6+

After cloning the repo, run:

$ npm install

Commonly used NPM scripts

### Start dev server with hot reload
npm run dev

### Check for errors
npm run lint

### Build everything
npm run build

### Build docs only
npm run build:docs

### Build lib only
npm run build:lib

The other tasks on package.json SHOULD NOT be executed.