2015-06-24 11:27:01 +00:00
# Contributing
2015-05-04 23:26:39 +00:00
2019-12-18 01:10:03 +00:00
***Ask not what Notepad++ can do for you - ask what you can do for Notepad++***
2015-05-04 23:26:39 +00:00
2015-10-02 14:08:51 +00:00
## Reporting Issues
2015-06-24 11:27:01 +00:00
2015-10-02 14:08:51 +00:00
Bug reports are appreciated. Following a few guidelines listed below will help speed up the process of getting them fixed.
2015-06-24 11:27:01 +00:00
2015-10-02 14:08:51 +00:00
1. Search the issue tracker to see if it has already been reported.
2. Disable your plugins to see if one of them is the problem. You can do this by renaming your `plugins` folder to something else.
2021-03-25 20:27:16 +00:00
3. Only report an issue with a plugin if it is one of the standard plugins included in the Notepad++ installation. Any other plugin issue should be reported to its respective issue tracker (see e.g. [plugin_list_x86.md ](https://github.com/notepad-plus-plus/nppPluginList/blob/master/doc/plugin_list_x86.md ) or [plugin_list_x64.md ](https://github.com/notepad-plus-plus/nppPluginList/blob/master/doc/plugin_list_x64.md ) to find the homepage with further informations on that for a plugins). The standard plugins include (for v7.9.5):
2015-10-02 14:08:51 +00:00
* NppExport
* Converter
* mimeTools
4. Include additional information such as:
* A detailed explanation
2021-03-25 20:27:16 +00:00
* Notepad++ Debug-Info containing:
* Operating System version
* Notepad++ version
* List of installed plugins (if it is related to a plugin)
2015-10-02 14:08:51 +00:00
* Screen shots (if applicable)
* ...and any other relevant information
2015-06-24 11:27:01 +00:00
2015-10-02 14:08:51 +00:00
## Pull Requests
2015-11-29 21:04:36 +00:00
Your pull requests are welcome; however, they may not be accepted for various reasons. If you want to make some GUI enhancement like renaming some graphic items or fixing typos, please create the issue instead of the pull requests. 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.
2015-06-24 11:27:01 +00:00
2022-08-30 17:25:35 +00:00
Opening an issue beforehand allows the administrators and the community to discuss bugs and enhancements before work begins, preventing wasted effort.
2015-06-24 11:27:01 +00:00
2015-10-02 14:08:51 +00:00
### Guidelines for pull requests
2015-05-04 23:26:39 +00:00
2021-02-20 12:02:31 +00:00
1. Respect existing Notepad++ coding style. Observe the code near your intended change, and attempt to preserve the style of that code with the changes you make.
2020-09-09 13:41:57 +00:00
2. Create a new branch for each PR. **Make sure your branch name wasn't used before** - you can add date (for example `patch3_20200528` ) to ensure its uniqueness.
2020-02-03 22:52:52 +00:00
3. Single feature or bug-fix per PR.
2021-01-16 11:07:51 +00:00
4. Create a PR with a single commit to make the review process easier.
2020-02-03 22:52:52 +00:00
5. Make your modification compact - don't reformat source code in your request. It makes code review more difficult.
6. 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.
2020-05-19 17:27:09 +00:00
7. Typo fixing and code refactoring won't be accepted - please create issues with title started with `TYPO` to request the changing.
2021-01-16 11:07:51 +00:00
8. Address the review change requests by pushing new commits to the same PR. Avoid amending a commit and then force pushing it. All the PR commits are squashed before merging to the main branch.
2015-06-24 11:45:12 +00:00
2015-05-05 22:46:37 +00:00
In short: The easier the code review is, the better the chance your pull request will get accepted.
2015-05-04 23:26:39 +00:00
2015-05-29 01:56:29 +00:00
2015-06-24 11:27:01 +00:00
2015-10-02 14:08:51 +00:00
### Coding style
2015-07-16 20:29:09 +00:00
![stay clean ](https://notepad-plus-plus.org/assets/images/good-bad-practice.jpg )
2015-06-24 11:27:01 +00:00
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
#### GENERAL
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
1. ##### Do not use Java-like braces.
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
2022-02-17 13:02:00 +00:00
void MyClass::method1()
2015-07-16 20:29:09 +00:00
{
2022-02-17 13:02:00 +00:00
if (aCondition)
{
// Do something
}
2015-07-16 20:29:09 +00:00
}
```
* ###### Bad:
```cpp
2022-02-17 13:02:00 +00:00
void MyClass::method1() {
if (aCondition) {
// Do something
}
2015-07-16 20:29:09 +00:00
}
```
2022-02-17 12:50:48 +00:00
However, the method definition could be defined in a header file (.h), if there's one line code only. In this case, Java-like braces should be used.
* ###### Good:
```cpp
class MyClass
{
public:
void method1();
int method2() {
return _x; // only one line code can be placed in .h as method definition
2022-02-17 13:02:00 +00:00
};
2022-02-17 12:50:48 +00:00
private:
int _x;
}
```
2019-12-28 05:05:19 +00:00
2. ##### 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).
2015-07-16 20:29:09 +00:00
2019-12-28 05:05:19 +00:00
3. ##### Always leave one space before and after binary and ternary operators.
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
2015-08-03 23:47:14 +00:00
if (a == 10 & & b == 42)
2015-07-16 20:29:09 +00:00
```
* ###### Bad:
```cpp
if (a==10& & b==42)
```
2019-12-28 05:05:19 +00:00
4. ##### Only leave one space after semi-colons in "for" statements.
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
for (int i = 0; i != 10; ++i)
```
* ###### Bad:
```cpp
for(int i=0;i< 10 ; + + i )
```
2019-12-28 05:05:19 +00:00
5. ##### Function names are not separated from the first parenthesis.
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
2015-05-29 01:56:29 +00:00
foo();
myObject.foo(24);
2015-07-16 20:29:09 +00:00
```
* ###### Bad:
```cpp
2015-05-29 01:56:29 +00:00
foo ();
2015-07-16 20:29:09 +00:00
```
2019-12-28 05:05:19 +00:00
6. ##### Keywords are separated from the first parenthesis by one space.
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
2015-05-29 01:56:29 +00:00
if (true)
while (true)
2015-07-16 20:29:09 +00:00
```
* ###### Bad:
```cpp
2015-05-29 01:56:29 +00:00
if(myCondition)
2015-07-16 20:29:09 +00:00
```
2019-12-28 05:05:19 +00:00
7. ##### Use the following indenting for "switch" statements:
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
```cpp
2015-05-29 01:56:29 +00:00
switch (test)
{
case 1:
2015-07-16 20:29:09 +00:00
{
// Do something
break;
}
default:
// Do something else
2015-05-29 01:56:29 +00:00
} // No semi-colon here
2015-07-16 20:29:09 +00:00
```
2019-12-28 05:05:19 +00:00
8. ##### Avoid magic numbers.
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
2021-03-04 23:51:19 +00:00
if (foo == I_CAN_PUSH_ON_THE_RED_BUTTON)
startTheNuclearWar();
2015-07-16 20:29:09 +00:00
```
* ###### Bad:
```cpp
while (lifeTheUniverseAndEverything != 42)
lifeTheUniverseAndEverything = buildMorePowerfulComputerForTheAnswer();
```
2019-12-28 05:05:19 +00:00
9. ##### Prefer enums for integer constants.
2015-07-16 20:29:09 +00:00
2019-12-28 05:05:19 +00:00
10. ##### Use initialization with curly braces.
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
MyClass instance{10.4};
```
* ###### Bad:
```cpp
MyClass instance(10.4);
```
2019-12-28 05:05:19 +00:00
11. ##### Always use `empty()` for testing if a string is empty or not.
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
2021-07-14 12:04:42 +00:00
if (!string.empty())
2015-07-16 20:29:09 +00:00
...
```
* ###### Bad:
```cpp
if (string != "")
...
```
2019-12-28 05:05:19 +00:00
12. ##### Always use `C++ conversion` instead of `C-Style cast` . Generally, all the conversion among types should be avoided. If you have no choice, use C++ conversion.
2016-08-17 09:54:53 +00:00
* ###### Good:
```cpp
char aChar = static_cast< char > (_pEditView->execute(SCI_GETCHARAT, j));
```
* ###### Bad:
```cpp
char aChar = (char)_pEditView->execute(SCI_GETCHARAT, j);
```
2021-02-20 12:02:31 +00:00
13. ##### Use `!` instead of `not` , `&&` instead of `and` , `||` instead of `or` .
* ###### Good:
```cpp
if (!::PathFileExists(dir2Search))
```
* ###### Bad:
```cpp
if (not ::PathFileExists(dir2Search))
```
2015-07-16 20:29:09 +00:00
#### NAMING CONVENTIONS
2019-12-28 05:05:19 +00:00
1. ##### Classes uses Pascal Case
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
class IAmAClass
{};
```
* ###### Bad:
```cpp
2019-12-28 05:05:19 +00:00
class iAmAClass
2015-07-16 20:29:09 +00:00
{};
2019-12-28 05:05:19 +00:00
class I_am_a_class
2015-07-16 20:29:09 +00:00
{};
```
2019-12-28 05:05:19 +00:00
2. ##### Methods & method parameters use camel Case
2015-07-16 20:29:09 +00:00
```cpp
2015-05-29 01:56:29 +00:00
void myMethod(uint myVeryLongParameter);
2015-07-16 20:29:09 +00:00
```
2019-12-28 05:05:19 +00:00
3. ##### Member variables
Any member variable name of class/struct should be preceded by an underscore.
2015-07-16 20:29:09 +00:00
```cpp
2015-05-29 01:56:29 +00:00
public:
int _publicAttribute;
private:
int _pPrivateAttribute;
float _pAccount;
2015-07-16 20:29:09 +00:00
```
2019-12-28 05:05:19 +00:00
4. ##### Always prefer a variable name that describes what the variable is used for.
2015-07-16 20:29:09 +00:00
* ###### Good:
```cpp
if (hours < 24 & & minutes < 60 & & seconds < 60 )
```
* ###### Bad:
```cpp
if (a < 24 & & b < 60 & & c < 60 )
```
2015-07-15 09:55:49 +00:00
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
#### COMMENTS
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
1. ##### Use C++ comment line style than C comment style.
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
* ###### Good:
```
// Two lines comment
// Use still C++ comment line style
```
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
* ###### Bad:
```
/*
Please don't piss me off with that
*/
```
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
#### BEST PRACTICES
2015-07-15 09:55:49 +00:00
2019-12-28 05:05:19 +00:00
1. ##### Use C++11/14/17 whenever it is possible
2015-07-15 09:55:49 +00:00
2019-12-28 05:05:19 +00:00
2. ##### Use C++11 member initialization feature whenever it is possible
2015-05-29 01:56:29 +00:00
2015-07-16 20:29:09 +00:00
```cpp
class Foo
{
int value = 0;
};
```
2020-11-15 08:34:21 +00:00
3. ##### Prefer Pre-increment:
2015-07-16 20:29:09 +00:00
```cpp
++i
```
2020-11-15 08:34:21 +00:00
##### **Over Post-increment:**
2015-07-16 20:29:09 +00:00
```cpp
i++
```
(It does not change anything for built-in types but it would bring consistency)
2015-05-29 01:56:29 +00:00
2019-12-28 05:05:19 +00:00
4. ##### 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.
2015-05-29 01:56:29 +00:00
2019-12-28 05:05:19 +00:00
5. ##### Avoid using new if you can use automatic variable. However, avoid `shared_ptr` as much as possible. Prefer `unique_ptr` instead.
2015-05-29 01:56:29 +00:00
2019-12-28 05:05:19 +00:00
6. ##### Don't place any "using namespace" directives in headers.
2015-05-29 01:56:29 +00:00
2019-12-28 05:05:19 +00:00
7. ##### Compile time is without incidence. Increasing compile time to reduce execution time is encouraged.
2015-05-29 01:56:29 +00:00
2019-12-28 05:05:19 +00:00
8. ##### Code legibility and length is less important than easy and fast end-user experience.