Skip to content

Latest commit

 

History

History
264 lines (186 loc) · 5.45 KB

CONTRIBUTING.md

File metadata and controls

264 lines (186 loc) · 5.45 KB

Contributing

Your pull requests are welcome; however, they may not be accepted for various reasons.

Before you contribute

All Pull Requests, except for translations and user documentation, need to be attached to a issue on GitHub. For Pull Requests regarding enhancements and questions, the issue must first be approved by one of project's administrators before being merged into the project. An approved issue will have the label Accepted. For issues that have not been accepted, you may request to be assigned to that issue.

Opening a issue beforehand allows the administrators and the community to discuss bugs and enhancements before work begins, preventing wasted effort.

Guidelines for pull requests

  1. Respect Notepad++ coding style.
  2. Make a single change per commit.
  3. Make your modification compact - don't reformat source code in your request. It makes code review more difficult.
  4. PR of reformatting (changing of ws/TAB, line endings or coding style) of source code won't be accepted. Use issue trackers for your request instead.

In short: The easier the code review is, the better the chance your pull request will get accepted.

Coding style

stay clean

GENERAL

  1. Do not use Java-like braces.
  • Good:
    if ()
    {
        // Do something
    }
  • Bad:
    if () {
        // Do something
    }
  1. Use tabs instead of white-spaces (we usually set our editors to 4 white-spaces for 1 tab, but the choice is up to you).
  2. Always leave one space before and after binary and ternary operators.
  • Good:
    if (a == 10 && b == 42)
  • Bad:
    if (a==10&&b==42)
  1. Only leave one space after semi-colons in "for" statements.
  • Good:
    for (int i = 0; i != 10; ++i)
  • Bad:
    for(int i=0;i<10;++i)
  1. Keywords are not function calls;

Function names are not separated from the first parenthesis.

  • Good:
    foo();
    myObject.foo(24);
  • Bad:
    foo ();
  1. Keywords are separated from the first parenthesis by one space.
  • Good:
    if (true)
    while (true)
  • Bad:
    if(myCondition)
  1. Use the following indenting for "switch" statements:
switch (test)
{
    case 1:
    {
        // Do something
        break;
    }
    default:
        // Do something else
} // No semi-colon here
  1. Avoid magic numbers.
  • Good:
    if (foo < I_CAN_PUSH_ON_THE_RED_BUTTON)
        startThermoNuclearWar();
  • Bad:
    while (lifeTheUniverseAndEverything != 42)
        lifeTheUniverseAndEverything = buildMorePowerfulComputerForTheAnswer();
  1. Prefer enums for integer constants.
  2. Use initialization with curly braces.
  • Good:
    MyClass instance{10.4};
  • Bad:
    MyClass instance(10.4);
  1. Always use empty() for testing if a string is empty or not.
  • Good:
    if (not string.empty())
    ...
  • Bad:
    if (string != "")
    ...

NAMING CONVENTIONS

  1. Classes (camel case)
  • Good:
    class IAmAClass
    {};
  • Bad:
    class iAmClass
    {};
    class I_am_class
    {};
  1. methods (camel case + begins with a lower case)

method parameters (camel case + begins with a lower case)

void myMethod(uint myVeryLongParameter);
  1. member variables

Any member variable name of class/struct should be preceded by an underscore.

public:
    int _publicAttribute;
private:
    int _pPrivateAttribute;
    float _pAccount;
  1. Always prefer a variable name that describes what the variable is used for.
  • Good:
    if (hours < 24 && minutes < 60 && seconds < 60)
  • Bad:
    if (a < 24 && b < 60 && c < 60)

COMMENTS

  1. Use C++ comment line style than C comment style.
  • Good:
    // Two lines comment
    // Use still C++ comment line style
    
  • Bad:
    /*
    Please don't piss me off with that
    */
    

BEST PRACTICES

  1. Use C++11/14 whenever it is possible
  2. Use C++11 member initialization feature whenever it is possible
class Foo
{
    int value = 0;
};
  1. Prefer this form:
++i

to:

i++

(It does not change anything for built-in types but it would bring consistency)

  1. Avoid using pointers. Prefer references. You might need the variable to be assigned a NULL value: in this case the NULL value has semantics and must be checked. Wherever possible, use a SmartPtr instead of old-school pointers.
  2. Avoid using new if you can use automatic variable. However, avoid shared_ptr as much as possible. Prefer unique_ptr instead.
  3. Don't place any "using namespace" directives in headers.
  4. Compile time is without incidence. Increasing compile time to reduce execution time is encouraged.
  5. Code legibility and length is less important than easy and fast end-user experience.