1
0
mirror of https://github.com/laurent22/joplin.git synced 2024-12-24 10:27:10 +02:00
joplin/CONTRIBUTING.md

35 lines
2.4 KiB
Markdown
Raw Normal View History

2019-01-09 19:07:43 +02:00
**IMPORTANT:** At the moment pull requests for new features are no longer being accepted. More info there: https://github.com/laurent22/joplin/issues/1112
* * *
# User support
For general discussion about Joplin, user support, software development questions, and to discuss new features, please go to the [Joplin Forum](https://discourse.joplin.cozic.net/). It is possible to login with your GitHub account.
2018-01-25 15:31:17 +02:00
# Reporting a bug
2018-03-09 10:47:21 +02:00
Please check first that it [has not already been reported](https://github.com/laurent22/joplin/issues?utf8=%E2%9C%93&q=is%3Aissue). Also consider [enabling debug mode](https://github.com/laurent22/joplin/blob/master/readme/debugging.md) before reporting the issue so that you can provide as much details as possible to help fix it.
2018-01-25 15:31:17 +02:00
2018-01-25 15:35:04 +02:00
If possible, **please provide a screenshot**. A screenshot showing the problem is often more useful than a paragraph describing it as it can make it immediately clear what the issue is.
2018-01-25 15:31:17 +02:00
# Feature requests
Again, please check that it has not already been requested. If it has, simply **up-vote the issue** - the ones with the most up-votes are likely to be implemented. "+1" comments are not tracked.
2018-01-25 15:31:17 +02:00
2019-01-25 19:14:17 +02:00
# Creating a pull request
2018-01-25 15:31:17 +02:00
2019-01-25 19:14:17 +02:00
- If you want to add a new feature, consider asking about it before implementing it or checking existing discussions to make sure it is within the scope of the project. That scope, due to limited resources, might be narrower than you think. As a rule of thumb **if your change is likely to involve more than 50 lines of code, you should discuss it in the forum**, just so that you don't waste your time implementing something that might not be accepted.
2019-03-07 11:13:34 +02:00
- Bug fixes have a very high chance of being accepted.
2019-01-25 19:14:17 +02:00
2019-03-08 10:34:48 +02:00
- A pull request that is relevant to the current roadmap has a very high chance of being accepted.
2018-09-05 12:17:47 +02:00
2019-01-25 19:14:17 +02:00
Building the apps is relatively easy - please [see the build instructions](https://github.com/laurent22/joplin/blob/master/BUILD.md) for more details.
2018-11-11 22:23:55 +02:00
2018-09-05 12:17:47 +02:00
# Coding style
There are only two rules, but not following them means the pull request will not be accepted (it can be accepted once the issues are fixed):
- **Please use tabs, NOT spaces.**
2018-11-11 22:23:55 +02:00
- **Please do not add or remove optional characters, such as spaces or colons.** Please setup your editor so that it only changes what you are working on and is not making automated changes elsewhere. The reason for this is that small white space changes make diff hard to read and can cause needless conflicts.