Skip to content

Latest commit

 

History

History
77 lines (51 loc) · 3.47 KB

CONTRIBUTING.md

File metadata and controls

77 lines (51 loc) · 3.47 KB

Contribute

This is the CONTRIBUTE section of our project. Great to have you here. Here are a few ways you can help make this project better!

Team Members

New Team Members Welcome...

Support

How can I help?

  • Simply use the module. The more people who use it, the better it will become.
  • Get Involved (see below for more details)
  • A freshly dropped star on the repo is always appreciated ;)

Learn & Listen

This section includes ways to get started with your open source project. Include links to documentation and to different communication channels:

  • How to Open Source - See this excellent article
  • To Learn about CIP and Ethernet/IP - See the Manuals folder
  • Ask - See the project Gitter community
  • Blog Posts - Coming Soon....

Get Involved

So you say you wanna help? Here's how! 🎉 👍

Submitting Issues

Contributing to the Code is great but feedback on the project is just as important.

  1. Research to make sure the issue isn't already being tracked
  2. Submit your issue via the project issue tracker
    • Be Clear
    • Be Thorough (too much information >>> not enough information)
    • Include Pictures (Screenshots of Errors, gifs, etc)
    • Include Node Version -> node --version
    • Include package version -> npm list

Protip: Use the project Issue Template as a starting point

Feature Requests

Have you ever been working with a project and thought Man, I wish it just did this out of the box?

  1. Submit your feature request to the issue tracker **Be Sure to Mark your Issue as a Feature Request in the title (eg [FEATURE REQUEST] Some Awesome Idea)
    • Be Clear
    • Be Thorough (too much information >>> not enough information)
    • Don't submit it and forget it, be prepared to answer some follow up questions

Protip: Use the project Issue Template as a starting point

Contributing Code

  1. Open an issue if one doesn't already partain to your contribution
  2. Discuss the changes you want to make in the issue tracker to see if someone is already working on it or if there is a reason it shouldn't be added
  3. Assumming the outcome of the above discussion good to go, fork the Repo
  4. Clone your forked copy to your local machine
  5. Add the host repo as upstream -> git remote add upstream https://github.com/cmseaton42/node-ethernet-ip.git
  6. Get acclamated with the environment (ask questions if necessary)
  7. Make a new branch for your changes
  8. Start hacking away at some crispy new code
  9. Make sure to add tests
  10. Submit you're PR to the Primary repo
  11. Wait for feedback
  12. Make changes if necessary and re-submit
  13. Boom, PR accepted 👍 💯 🎉