You are here to help on vue-formly-buefy? Awesome, feel welcome and read the following sections to know what and how to work on something.
It's an open source project and we love to receive contributions from our community — you! There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, submitting bug reports and feature requests or writing code which can be incorporated into vue-formly-buefy itself.
All members of our community are expected to follow our Code of Conduct. Please make sure you are welcoming and friendly in all of our spaces.
Before you submit an issue, please search the issue tracker, maybe an issue for your problem already exists and the discussion might inform you of workarounds readily available.
We want to fix all the issues as soon as possible, but before fixing a bug we need to reproduce and confirm it. In order to reproduce bugs we ask you to provide a minimal reproduction scenario that include:
- Version of the plugin used.
- Environment information (3rd-party libraries, technology stack etc.).
- A use-case that fails.
If you get stuck at any point you can create a ticket on GitHub.
Working on your first Pull Request? You can learn how from this free series, How to Contribute to an Open Source Project on GitHub.
If you would make PR for something that is bigger than a one or two line fix:
- Create your own fork of the code.
- Before start development be sure you are following:
- Our Code of Conduct.
- The documented overview to have a particular roadmap.
- The code style for the project (use our
.eslintrc
). - Commit message convention (sentence case, present time).
- Do the changes in your fork.
- Write one or more specs (unit-tests) for all features or bug fixes.
- Provide documentation for all public API methods.
- Only if you like the change and think the project could use it:
- Send a pull request.
To run the project for development use the following micro guide:
- Get local copy of the project.
- Be sure that Docker, Docker Compose and Google Chrome (needs for test) installed.
- Kill a process which occupy the
9876
port (needs for test). - Set the
yarn && yarn test
command for thenode
service in thedocker-compose.yml
. - Open root directory of the project in the terminal and run the
docker-compose up
command.
When work has done properly all npm packages will be install and Karma test server run on the 9876
port.