Skip to content

Latest commit

 

History

History
49 lines (34 loc) · 3.48 KB

CONTRIBUTING.md

File metadata and controls

49 lines (34 loc) · 3.48 KB
Raw

How to contributing to Pyrez

First off, thank you for considering contributing to Pyrez. It makes the library substantially better. 👍

The following is a set of guidelines for contributing to the repository. These are guidelines, not hard rules.

Please try your best not to ask questions in our issue tracker.

Support questions

Please, don't use the issue tracker for this. Use our Discord support server for questions about your own code.

Good Bug Reports

Please be aware of the following things when filing bug reports.

  1. Don't open duplicate issues. Please search your issue to see if it has been asked already. Duplicate issues will be closed.
  2. When filing a bug about exceptions or tracebacks, please include the complete traceback. Without the complete traceback the issue might be unsolvable and you will be asked to provide more information.
  3. Make sure to provide enough information to make the issue workable. The issue template will generally walk you through the process but they are enumerated here as well:
    • A summary of your bug report. This is generally a quick sentence or two to describe the issue in human terms.
    • Guidance on how to reproduce the issue. Ideally, this should have a small code sample that allows us to run and see the issue for ourselves to debug. Please make sure that the token is not displayed. If you cannot provide a code snippet, then let us know what the steps were, how often it happens, etc.
    • Tell us what you expected to happen. That way we can meet that expectation.
    • Tell us what actually happens. What ends up happening in reality? It's not helpful to say "it fails" or "it doesn't work". Say how it failed, do you get an exception? Does it hang? How are the expectations different from reality?
    • Tell us information about your environment. What version of discord.py are you using? How was it installed? What operating system are you running on? These are valuable questions and information that we use.

If the bug report is missing this information then it'll take us longer to fix the issue. We will probably ask for clarification, and barring that if no response was given then the issue will be closed.

Submitting a Pull Request

Submitting a pull request is fairly simple, just make sure it focuses on a single aspect and doesn't manage to have scope creep and it's probably good to go. It would be incredibly lovely if the style is consistent to that found in the project. This project follows PEP-8 guidelines (mostly) with a column limit of 125.

Git Commit Guidelines

  • Use present tense (e.g. "Add feature" not "Added feature")
  • Limit all lines to 72 characters or less.
  • Reference issues or pull requests outside of the first line.
    • Please use the shorthand #123 and not the full URL.

Code Style Guide

The Pyrez codebase uses the PEP 8 code style, and follows Semantic Versioning.

In addition to the standards outlined in PEP 8, we have a few guidelines:

  • Use 4 spaces for tabs, never tab characters.
  • No trailing whitespace, blank lines should have no whitespace.
  • Naming styles:
    • Always use the CapitalizedWords convention for Classes names.
    • Always use the mixedCase convention for Function, Method, and Variable names.
  • Always use single-quoted strings (e.g. '#flatearth'), unless a single-quote occurs within the string.