Skip to content

Latest commit

 

History

History
52 lines (28 loc) · 3.3 KB

CONTRIBUTING.md

File metadata and controls

52 lines (28 loc) · 3.3 KB
Raw

How to contribute

I'm really glad you're reading this, because this will help us help you. We hope you like NetBots and want to hear from you. The guidelines below help us communicate and work together smoothly.

Do you have questions about writing a robot, about the NetBots source code, or other questions?

  • Ensure your question has not already been answered in the README or by searching existing issues.

  • If you're unable to find the information you need, open a new issue. Be sure to include a descriptive title and follow the suggested template as much as possible. Provide as much relative information as possible.

Did you find a bug?

  • Ensure the bug was not already reported by searching existing issues.

  • If you're unable to find an issue discussing the problem, open a new bug report. Be sure to include a descriptive title and follow the suggested template as much as possible. Provide as much relative information as possible.

Do you intend to add a new feature or change an existing one?

  • Before submitting a pull request, suggest your change with a Feature Request so your idea can be discussed. There is no point in writing code when your idea may not be accepted.

Submitting Feature Changes or Bug Fixes (Pull Request)

Please submit a new GitHub Pull Request with a clear list of what you've done.

  • Reference the feature request issue or bug report issue it relates to.
  • Make sure all of your commits are atomic (one feature per commit).
  • Each commit should clearly describes the change.
  • Please follow our coding conventions below.
  • Ensure your code is tested. Describe what tests you did in the pull request.

Did you write a cool robot and want to share it?

In general, new robots will not be accepted. The point of NetBots is to learn from writing robots. Publicly posting NetBots robots you have written is discouraged as it reduces the usefulness of NetBots as a learning tool for others.

Did you fix whitespace, format code, or make a purely cosmetic change?

Changes that are cosmetic in nature and do not add anything substantial to the stability, functionality, or testability will generally not be accepted. We know our formatting is not perfect but please only clean up formatting when code needs changing anyway. If this really bugs you then suggest a new feature that is purely for formatting clean up and we can discuss it.

Coding Conventions

Start reading the NetBots code and you'll get the hang of it. We are far from perfect and we don't expect you to be.

  • Indent using four spaces (soft tabs)
  • Line length must not exceed 120 characters.
  • Consider the people who will read your code, and make it look nice for them.
  • Beyond that we suggest following PEP-0008.

Thanks for reading this!