]> CyberLeo.Net >> Repos - Github/YOURLS.git/blob - CONTRIBUTING.md
Add plain API format
[Github/YOURLS.git] / CONTRIBUTING.md
1 Contributing to YOURLS
2 ======================
3
4 Please take a moment to review this document, or see your issue / pull request closed with *harsh comments* :-)
5
6 Following these guidelines helps to communicate that you respect the time of
7 the developers managing and developing for free this open source project during their free time.
8 Thank you for this, and in return we will reciprocate that respect in addressing your issue
9 or assessing patches with goodwill.
10
11 Search before
12 -------------
13
14 The issue tracker is the preferred channel for bug reports, features requests and submitting pull
15 requests, but please respect the following restrictions:
16
17 * Please **do not** use the issue tracker for personal support requests. Use sites such as
18   [Stack Overflow](http://stackoverflow.com) instead.
19 * Please, please, please, **SEARCH** before you file a new issue or request.
20
21 Guidelines
22 ----------
23
24 Before using the issue tracker, we require you read the specific guidelines, depending on the topic:
25 a bug report, a feature request or a pull request.
26
27 ### Bug Report
28
29 Good bug reports are extremely helpful - thank you! Good bug reports are also quite rare.  
30 To help and raise the bug report quality, **you _must_ read the wiki document about [Bug Reports](https://github.com/YOURLS/YOURLS/wiki/Bug-Report).**
31
32 ### Feature Request
33
34 Feature requests are welcome. But take a moment to find out whether your idea fits the scope and
35 goals of the project. Check also the [Roadmap](https://github.com/YOURLS/YOURLS/wiki/Road-Map),
36 maybe your idea is already planned.
37
38 It's up to you to make a strong case to convince the project's developers of the merits of this feature.
39 Please provide as much detail and context as possible and get in touch. Feel free to detail how you envision
40 things, be they about (pseudo)code, interface, mockup, etc...
41
42 ### Pull Request
43
44 Good pull requests are a fantastic help. But please get in touch before you start working,
45 it's always a sad moment to dismiss a patch for which a coder has spent a lot of time because
46 it simply does not fit the project. Please read the wiki
47 document about [Pull requests](https://github.com/YOURLS/YOURLS/wiki/Pull-Request).