Skip to content

Latest commit

 

History

History
42 lines (24 loc) · 2.05 KB

CONTRIBUTING.md

File metadata and controls

42 lines (24 loc) · 2.05 KB
Raw

Contributing

Thanks for being there!

There are many ways you can help in the OpenNMT-tf project. This document will guide you through this process.

Reporting issues

We use GitHub issues for bugs in the code that are reproducible. A good bug report should contain every information needed to reproduce it. Before opening a new issue, make sure to:

  • use the GitHub issue search for existing and fixed bugs;
  • check if the issue has been fixed in a more recent version;
  • isolate the problem to give as much context as possible.

If you have questions on how to use the project or have trouble getting started with it, consider using our forum instead and tagging your topic with the tensorflow tag.

Requesting features

Do you think a feature is missing or would be a great addition to the project? Please open a GitHub issue to describe it.

Developing features

You want to share some code, that's great!

  • If you want to contribute with code but are unsure what to do, look for GitHub issues marked with the contributions welcome label. These are developments that we find particularly suited for community contributions.
  • If you are planning to make a large change to the existing code, consider asking first on the forum or Gitter to confirm that it is welcome.

In any cases, your new code must:

  • pass the existing tests

and should:

  • pass the pylint code checker (we use the TensorFlow Python coding style with relaxed line length)
  • add new tests
  • update the documentation

Helping others

The project supports many model and training configurations. Sharing experiences (for example on the forum) with existing or new configurations is highly appreciated.

Also, people often ask for help or suggestions on the forum or on Gitter. Consider visiting them regularly and help some of them!