Skip to content

Latest commit

 

History

History
68 lines (47 loc) · 3.94 KB

CONTRIBUTING.md

File metadata and controls

68 lines (47 loc) · 3.94 KB
Raw

Contributing to babel-plugin-cloudinary

Thank you for contributing to babel-plugin-cloudinary!

This project is released with a Contributor Code of Conduct By participating you agree to comply with its terms.

Table Of Contents

How Can I Contribute?

How can I contribute?

Improve documentation

Most simple way to contribute is improving our documentation. Fixing typo's, fixing errors, explaining something better, more examples etc. If your work would be a big change, open an issue first. For smaller changes feel free to open a PR directly.

Use common sense to decide if you need an issue or not. Generally if you change more than a few paragraphs, multiple files etc, it is better to open an issue and explain your change.

Reporting Bugs

If you encounter any issues with babel-plugin-cloudinary don't hesitate to report it. While reporting your bug make sure you follow the guidelines below. It helps maintainers to understand and reproduce the problem.

  • Use a clear and descriptive title for the issue to identify the problem.
  • Provide configuration you used which is critical for reproducing problem in most cases.
  • Provide system details you used to identify if the problem is system specific. I.e: operating system, node version, webpack version you used etc.
  • Describe the exact steps which reproduce the problem in as many details as possible.
  • Describe the behavior you observed after following the steps and point out what exactly is the problem with that behavior.
  • Explain which behavior you expected to see instead and why.

Note: If you find a Closed issue that seems like it is the same thing that you're experiencing, open a new issue and include a link to the original issue in the body of your new one.

Writing code

Find an issue you want to work on, or if you have your own idea create an issue. You might find an issue assigned. Double-check if somebody else is working on the same issue.

Local development

It usually is a good idea to create a dummy repository to run your changes.

While writing code make sure you follow this guidelines:

  • Use recommended indentation (check .editorconfig)
  • Always use strict equality checks === instead of ==.
  • Make sure your code runs on node 8.
  • Write tests and run them. Check coverage before submitting.
  • Write documentation for your code (if you don't write it, pipeline lint check will break).

Pull Requests

  • Non-trivial changes are often best discussed in an issue first, to prevent you from doing unnecessary work.
  • For ambitious tasks, you should try to get your work in front of the community for feedback as soon as possible. Open a pull request as soon as you have done the minimum needed to demonstrate your idea. At this early stage, don't worry about making things perfect, or 100% complete. Add a [WIP] prefix to the title, and describe what you still need to do. This lets reviewers know not to nit-pick small details or point out improvements you already know you need to make.
  • New features should be accompanied with tests and documentation.
  • Don't include unrelated changes.
  • Make the pull request from a topic branch, not master.
  • Use a clear and descriptive title for the pull request and commits.
  • Write a convincing description of why we should land your pull request. It's your job to convince us. Answer "why" it's needed and provide use-cases.
  • You might be asked to do changes to your pull request. There's never a need to open another pull request. Just update the existing one.
  • Be patient, we might not find time to check on your pull requests immediately. It will be checked eventually.